# 提交视频任务

提交一次，并保存返回的任务 ID。

`POST /v1/videos`

<a id="authentication"></a>

## 鉴权

使用 Authorization: Bearer YOUR_API_KEY。所选模型须在该密钥分组内开放；JSON 请求使用 Content-Type: application/json。

<a id="parameters"></a>

## 参数



| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| model | string | 必填 | 示例：seedance-2.0-fast。 |
| prompt | string | 必填 | 本最小示例使用文本提示词。 |
| seconds | number | 可选 | 示例请求 5 秒；支持范围取决于模型。 |
| resolution | string | 可选 | 示例使用 720p，具体支持范围以模型为准。 |

<a id="request"></a>

## 请求示例



```
export OHGROK_API_KEY='YOUR_API_KEY'

curl --fail-with-body --silent --show-error \
  'https://api.ohgrok.com/v1/videos' \
  -H "Authorization: Bearer $OHGROK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0-fast",
    "prompt": "Clouds moving slowly over a quiet mountain lake",
    "seconds": 5,
    "resolution": "720p"
  }' \
  -o video-response.json
```

<a id="response"></a>

## 响应结构

保存返回的 id，后续查询该 ID，不要重复创建任务。当前配置支持 JSON 与 URL 引用的 multipart 请求；本地二进制上传、草稿引用和 frames 暂未实现。本页提供最小 JSON 流程。

```
{"id":"YOUR_VIDEO_ID","status":"queued"}
```

<a id="errors"></a>

## 错误处理

结合 HTTP 状态与返回的错误信息排查。鉴权或模型权限错误先检查密钥与分组；额度或限流错误检查余额及上游限制；超时时保留已有任务 ID。

- [排查一次请求](/zh/docs/errors/)