927AI API 文档
官网控制台模型与价格文档首页
官网控制台模型与价格文档首页
  1. OpenAI 格式
  • 快速开始
    • 欢迎使用
    • 价格说明
  • 开发工具接入
    • 开发工具接入
    • 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 格式
          • 创建视频生成任务
          • 查询视频生成任务
          • 下载生成的视频
        • 火山方舟格式
          • 创建视频生成任务
          • 查询视频生成任务
      • Grok
        • OpenAI 格式
          • 创建 Grok 视频任务
            POST
          • 查询 Grok 视频任务
            GET
          • 下载 Grok 视频
            GET
      • Wan
        • OpenAI 格式
          • 创建 Wan 视频任务
          • 查询 Wan 视频任务
          • 下载 Wan 视频
  1. OpenAI 格式

查询 Grok 视频任务

GET
/v1/videos/{task_id}
查询视频生成任务的最新状态。建议使用创建任务返回的 id 作为 task_id,并采用 5 至 10 秒间隔轮询。
状态包括:queued(排队中)、in_progress(生成中)、completed(已完成)、failed(失败)。
任务完成时,视频地址位于 metadata.url;失败时,错误信息位于 error.message 和 error.code。

请求参数

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

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://vip.927ai.ai/v1/videos/task_927ai_example' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200
application/json
已成功获取视频任务状态
Bodyapplication/json

示例
{
    "id": "task_927ai_example",
    "task_id": "task_927ai_example",
    "object": "video",
    "model": "doubao-seedance-2-0-fast-260128",
    "status": "in_progress",
    "progress": 50,
    "created_at": 1764347090
}
🟠400BadRequest
🟠401Unauthorized
🟠403Forbidden
🟠429RateLimited
🔴500InternalError
上一页
创建 Grok 视频任务
下一页
下载 Grok 视频
Built with