API 参考
创建视频任务
调用 NeonAPI 所需的接口、请求参数与响应结构。
POST /v1/videos
身份验证
将 NeonAPI 密钥放入 Authorization: Bearer YOUR_API_KEY 请求头，在可信应用环境中保管密钥。
可用性与兼容性
调用前核对模型的协议、权限、报价和支持参数。不支持的参数可能被拒绝。示例中的密钥与模型均为占位符。
请求参数
multipart/form-data
| 字段 | 类型 | 必填 | 约束 | 含义 |
|---|---|---|---|---|
model | string | 否 | — | 模型广场发布的准确 ID。 |
prompt | string | 否 | — | 指令或生成提示词。 |
seconds | string | 否 | — | — |
input_reference | string | 否 | binary | — |
完整字段定义、嵌套对象和引用结构可在下载的规范中查看。
请求示例
export NEON_API_KEY="YOUR_API_KEY"
curl https://neon-api.com/v1/videos \
-H "Authorization: Bearer $NEON_API_KEY" \
-F "model=YOUR_MODEL_ID" \
-F "prompt=A slow journey through a constellation"响应说明
实际字段因模型与协议而异。下方结构描述文档中的成功响应；流式请求使用对应协议的事件。
| 状态码 | 含义 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数错误 |
响应结构
| 字段 | 类型 | 必填 | 约束 | 含义 |
|---|---|---|---|---|
id | string | 是 | — | 该结果或任务的标识符。 |
object | string | 是 | — | — |
model | string | 是 | — | 模型广场发布的准确 ID。 |
status | string | 是 | — | 当前异步任务状态。 |
progress | integer | 是 | — | — |
created_at | integer | 是 | — | — |
seconds | string | 是 | — | — |
completed_at | integer | 否 | — | — |
expires_at | integer | 否 | — | — |
size | string | 否 | — | — |
error | OpenAIVideoError | 否 | — | — |
metadata | object | 否 | — | — |