1. OpenAI 兼容异步视频
星核API国际站
  • 开始
  • 模型API
    • 文本生成
      • OpenAI Chat Completions API
      • OpenAI Responses API
      • Anthropic Messages API
    • 图片生成
      • OpenAI 兼容异步生图
        • 提交图片生成任务
        • 查询图片生成任务
        • 提交图片编辑任务
        • 查询图片编辑任务
    • 视频生成
      • OpenAI 兼容异步视频
        • 提交视频生成任务
          POST
        • 查询视频生成任务
          GET
      • Seedance 官方 Ark 视频
        • 提交视频生成任务
        • 查询视频生成任务
  1. OpenAI 兼容异步视频

提交视频生成任务

POST
/v1/videos
接入信息值
Base URLhttps://api.starcore.cloud
请求POST /v1/videos
鉴权Authorization: Bearer <YOUR_API_KEY>
请求格式application/json
提交后保存响应 id,使用对应查询接口获取结果。任务以异步方式处理,无需传 async。

参数与素材#

示例模型 dreamina-seedance-2.5 使用以下字段:
字段含义示例
prompt提示词描述画面、动作和镜头
duration视频秒数4
resolution分辨率720p
aspect_ratio画面比例16:9
参考图、首尾帧、参考视频及音频使用参数表中的对应 URL 字段,素材需为可访问的 HTTPS 地址;是否支持以具体模型为准。首尾帧模式不与其他参考素材混用。
其他支持 OpenAI 风格的模型可使用 seconds + size。请按模型支持的格式填写,不要与 duration + resolution 同时传入。本接口使用 JSON,不提供文件表单上传。

cURL 示例#

整段复制到 Apipost / Apifox 的 cURL 导入,替换 <YOUR_API_KEY> 后使用。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Header 参数

Body 参数application/json必填

示例
{
    "model": "dreamina-seedance-2.5",
    "prompt": "A quiet lake at sunrise, gentle ripples, static camera.",
    "duration": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL(JSON,可直接导入)
curl --request POST --url 'https://api.starcore.cloud/v1/videos' --header 'Authorization: Bearer <YOUR_API_KEY>' --header 'Content-Type: application/json' --data-raw '{"model":"dreamina-seedance-2.5","prompt":"A quiet lake at sunrise, gentle ripples, static camera.","duration":4,"resolution":"720p","aspect_ratio":"16:9"}'

返回响应

🟢200
application/json
任务已受理
Bodyapplication/json

示例
{
    "id": "task_example_01",
    "object": "video",
    "model": "dreamina-seedance-2.5",
    "status": "queued",
    "progress": 0,
    "created_at": 1792454400
}
🟠400
🟠401
🟠403
🟠404
🟠429
🔴502
🔴503
修改于 2026-10-22 03:43:52
上一页
查询图片编辑任务
下一页
查询视频生成任务
Built with