927AI API 文档
官网控制台模型与价格文档首页
官网控制台模型与价格文档首页
  1. 火山方舟格式
  • 快速开始
    • 欢迎使用
    • 价格说明
  • 开发工具接入
    • 开发工具接入
    • Claude Code
    • Codex
    • Cursor
    • OpenCode
    • Grok CLI
    • Gemini CLI
    • OpenClaw
    • Hermes
    • WorkBuddy
    • 常见问题
  • 模型 API 接口
    • OpenAI 格式
      • 文本生成
        • Completions
        • Responses
      • 图片
        • 图片生成
        • 图片编辑
    • Anthropic 格式
      • 文本生成
        • Messages
    • Gemini 格式
      • 模型
        • Models
      • 内容生成
        • Generate Content
        • Stream Generate Content
      • 向量化
        • Embed Content
        • Batch Embed Contents
    • 视频生成API
      • Seedance
        • OpenAI 格式
          • 创建视频生成任务
          • 查询视频生成任务
          • 下载生成的视频
        • 火山方舟格式
          • 创建视频生成任务
            POST
          • 查询视频生成任务
            GET
      • Grok
        • OpenAI 格式
          • 创建 Grok 视频任务
          • 查询 Grok 视频任务
          • 下载 Grok 视频
      • Wan
        • OpenAI 格式
          • 创建 Wan 视频任务
          • 查询 Wan 视频任务
          • 下载 Wan 视频
  1. 火山方舟格式

创建视频生成任务

POST
/doubao/api/v3/contents/generations/tasks
按火山方舟 Seedance 原生格式创建异步视频任务。
请求中的 content、duration、resolution、ratio 等字段保持火山方舟结构。
创建成功后返回任务 id,请保存该 ID 并用于后续状态查询。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
        {
            "type": "text",
            "text": "一只小猫在阳光下的草地上缓慢行走,镜头固定,画面自然。"
        }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://vip.927ai.ai/doubao/api/v3/contents/generations/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
        {
            "type": "text",
            "text": "一只小猫在阳光下的草地上缓慢行走,镜头固定,画面自然。"
        }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false
}'

返回响应

🟢200
application/json
已成功创建视频任务
Bodyapplication/json

示例
{
    "id": "task_927ai_example"
}
🟠400BadRequest
🟠401Unauthorized
🟠403Forbidden
🟠413PayloadTooLarge
🟠429RateLimited
🔴500InternalError
上一页
下载生成的视频
下一页
查询视频生成任务
Built with