API reference
Get video task status
Endpoints, request fields and response schemas for calling NeonAPI.
GET /v1/videos/{task_id}
Authentication
Use your NeonAPI API key in Authorization: Bearer YOUR_API_KEY. Keep the key in a trusted application environment.
Availability and compatibility
Check the selected model’s protocol, permissions, price and supported parameters before calling. Unsupported parameters may be rejected. Request examples use placeholders.
Path and query parameters
| Field | In | Type | Required |
|---|---|---|---|
task_id | path | string | Yes |
Request fields
No request body.
Request example
export NEON_API_KEY="YOUR_API_KEY"
curl https://neon-api.com/v1/videos/YOUR_TASK_ID \
-H "Authorization: Bearer $NEON_API_KEY"Responses
Fields vary by model and protocol. The schema below describes the documented successful response; streams use protocol-specific events.
| Status | Meaning |
|---|---|
| 200 | Successful response |
| 404 | Successful response |
Response schema
| Field | Type | Required | Constraints | Meaning |
|---|---|---|---|---|
id | string | Yes | — | Identifier returned for this result or task. |
object | string | Yes | — | — |
model | string | Yes | — | Exact published model ID. |
status | string | Yes | — | Current asynchronous task state. |
progress | integer | Yes | — | — |
created_at | integer | Yes | — | — |
seconds | string | Yes | — | — |
Download the user API OpenAPI specification
See errors and streaming & tasks.