MaaS_Sora-2文生视频

1.创建视频任务

请求路径

POST https://genaiapi.cloudsway.net/v1/ai/{endpoint}/videos

请求参数

参数名	类型	是否必填	描述
prompt	String	是	用自然语言描述镜头。请包含镜头类型、主体、动作、场景、灯光以及任何所需的镜头运动，以减少歧义。为了确保最佳一致性，请保持单一用途。
size	String	否	视频宽×高，可选值: 720×1280、 1280×720 默认: 720×1280
seconds	String	否	4 / 8 / 12 默认值： 4
input_reference	File	否	用作第一帧视觉锚点的单幅参考图像。 接受的 MIME 类型：image/jpeg、image/png、image/webp。尺寸必须完全匹配。
remix_video_id（暂不支持）	String	否	之前完成的视频 ID（例如video_...），用于重复使用结构、动作和取景。与 Sora 2 相同

响应示例

{
    "id": "video_68f892a69ee081908d83e200aa406fec",
    "object": "video",
    "created_at": 1761120934,
    "status": "queued",
    "completed_at": null,
    "error": null,
    "expires_at": null,
    "model": "sora-2",
    "progress": 0,
    "remixed_from_video_id": null,
    "seconds": "4",
    "size": "1280x720"
}

调用示例

curl --location --request POST 'https://genaiapi.cloudsway.net/v1/ai/{endpoint}/videos' \
--header 'Authorization: Bearer {key}' \
--form 'prompt="橘猫在晒太阳"' \
--form 'size="1280x1792"' \
--form 'seconds="12"'

2. 查询视频任务状态

请求路径

GET https://genaiapi.cloudsway.net/v1/ai/{endpoint}/videos/{video_id}

响应示例

{
    "id": "video_68f872d114108190b620f73a4af85c5e",
    "object": "video",
    "created_at": 1761112785,
    "status": "completed",
    "completed_at": 1761112941,
    "error": null,
    "expires_at": 1761199185,
    "model": "sora-2",
    "progress": 100,
    "remixed_from_video_id": null,
    "seconds": "12",
    "size": "720x1280"
}

调用示例

curl --location --request GET 'https://genaiapi.cloudsway.net/v1/ai/{endpoint}/videos/{video_id}' \
--header 'Authorization: Bearer {key}'

3.下载视频

请求路径

GET https://genaiapi.cloudsway.net/v1/ai/{endpoint}/videos/{video_id}/content

调用示例

curl --location --request GET 'https://genaiapi.cloudsway.net/v1/ai/{endpoint}/videos/{video_id}/content' \
--header 'Authorization: Bearer {key}'