VideosOpenAI Compatible

查询视频任务

查询 OpenAI 兼容 /v1/videos 任务状态与结果。

Authorization

bearerAuth

AuthorizationBearer <token>

使用 Authorization Bearer API Key 进行鉴权。

In: header

Path Parameters

task_id*string

视频生成任务 ID。

Response Body

`application/json`

`application/json`

`application/json`

curl -X GET "https://example.com/v1/videos/task_123456"

{
  "id": "task_123456",
  "task_id": "task_123456",
  "object": "video",
  "status": "completed",
  "model": "string",
  "created_at": 0,
  "updated_at": 0,
  "completed_at": 0,
  "expires_at": 0,
  "seconds": "string",
  "size": "string",
  "progress": 0,
  "url": "http://example.com",
  "video_url": "http://example.com",
  "content_url": "http://example.com",
  "remixed_from_video_id": "string",
  "output": [
    {}
  ],
  "metadata": {
    "url": "string",
    "usage": {
      "completion_tokens": 0,
      "total_tokens": 0,
      "tool_usage": {
        "web_search": 0
      }
    },
    "last_frame_url": "http://example.com",
    "output_format": "string",
    "duration": 0,
    "duration_seconds": 0,
    "resolution": "string",
    "ratio": "string",
    "seed": 0,
    "generate_audio": true,
    "draft": true,
    "draft_task_id": "task_DRAFT_PUBLIC_ID"
  },
  "error": {}
}

{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

Video Generation

通过 OpenAI 兼容的 `/v1/videos` 接口创建视频生成任务，适用于 PixVerse、Veo、Seedance、Wan 3.0 等兼容提供商。 Grok 视频生成也使用该接口，模型可选 `grok-imagine-video` 或 `grok-imagine-video-1.5-preview`。Grok 请求使用 `application/json`，可通过 `reference_images` 传参考图片 URL，并通过 `video.url` 传参考视频 URL。 Wan 3.0 可使用与 `/v1/video/generations` 相同的通用请求字段。需要完整原生媒体和参数时，通过 `metadata.input.media` 和 `metadata.parameters` 传入。 Seedance 2.0 / 2.5 素材支持自动上传：在图片、视频或音频素材字段中直接传入公网可访问的 `https://` 链接，系统会自动识别并上传素材，无需提前调用 `/api/assets/upload`。 Seedance 2.5 任务类型放在顶层 `omni_reference_task_type`，兼容 `metadata.omni_reference_task_type`（顶层优先）；`metadata.content` 非空时完整替换快捷媒体映射。编辑使用 `duration: -1` 和 `metadata.ratio: adaptive`；延长也要求 `metadata.ratio: adaptive`。`seconds` 与 `duration` 不要传冲突值。Seedance 的 `watermark`、`return_last_frame`、`seed`、`camera_fixed`、`draft`、`service_tier`、`execution_expires_after`、`priority`、`safety_identifier`、`callback_url`、`output_format`、`tools`、`frames` 放在 `metadata` 下；所有内置 Seedance 路径保留显式 false/0，多视频和多音频数组不会截为第一项。网关已部署草稿模式支持，实际可用性取决于所选渠道、上游账号和模型。先以 `metadata.draft: true`、`size: 480p` 创建 Seedance 2.5 样片；成功后，使用本用户的 ModelSell `task_…` ID 创建正式片，`metadata.content` 只包含一个 `draft_task`，`size` 为 `1080p`（或省略），`metadata.draft` 省略或为 `false`。正式片不得再次传提示词、媒体、`duration` / `seconds`、`ratio`、`seed`、`generate_audio` 或 `omni_reference_task_type`；这些参数自动复用样片。样片 ID 从创建起 7 天有效，两步独立计费。尚未完成真实付费样片及正式片生成验证。

Download Video Content

下载已生成的视频内容，适用于提供 content 端点的视频模型。