ModelSell Docs
VideosOpenAI Compatible

查询视频任务

GET
/v1/videos/{task_id}

查询 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
  },
  "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,多视频和多音频数组不会截为第一项。

Download Video Content

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