AI 文生视频

ai-videoPOST
POSThttps://v1.apizero.cn/v1/chat/completions
收费档

默认经济档(最低)。适中、较贵同一模型价更高。

加载中…

概述

文生视频走大模型同一地址:POST https://v1.apizero.cn/v1/chat/completions。换视频模型只改 model。默认经济档。套餐请开通企业会员或大模型页已有视频月卡,本接口不另开套餐。

调用约定

  • 网关 · https://v1.apizero.cn/v1/chat/completions
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0,不要只看 HTTP 200。
/aidocs/ai-video/raw.md
打开 Markdown

鉴权

本接口无匿名/登录免费额度,需携带有效 API Key,按次、点数或会员套餐计费。鉴权字段与兼容写法见下方「请求头说明」。

获取 API Key

请求头

Authorizationstring必填

必填鉴权。推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。付费接口需携带有效 Key。

文生视频

POSTAPPLICATION/JSON·APPLICATION/JSON

和「大模型」是同一条网关,不另写一套生成逻辑。POST https://v1.apizero.cn/v1/chat/completions,SDK base 填 https://v1.apizero.cn/v1。换视频模型只改 model。有的按次、有的按时长,以价目表为准。默认经济档。套餐请开通企业会员,或到大模型页开通已有视频月卡,本接口不另开套餐。

https://v1.apizero.cn/v1/chat/completions?model=viduq3&tier=economy&messages=%5B%7B%22role%22%3A%22user%22%2C%22content%22%3A%22%E4%B8%80%E5%8F%AA%E9%87%91%E6%AF%9B%E5%9C%A8%E8%8D%89%E5%9C%B0%E4%B8%8A%E5%A5%94%E8%B7%91%EF%BC%8C%E6%85%A2%E9%95%9C%E5%A4%B4%EF%BC%8C%E9%98%B3%E5%85%89%22%7D%5D

model(模型)string必填

视频模型 ID,见本页模型表或 ?type=video

例viduq3

tier(收费档)string选填

收费档:economy 经济(默认、最低)/ standard 适中 / plus 较贵

例economy

messages(对话消息)array必填

OpenAI 风格 messages,提示词放在 user content

例[{"role":"user","content":"一只金毛在草地上奔跑,慢镜头,阳光"}]

{
  "model": "viduq3",
  "tier": "economy",
  "messages": "[{\"role\":\"user\",\"content\":\"一只金毛在草地上奔跑,慢镜头,阳光\"}]"
}

返回结果

idstring

本次请求 ID

objectstring

固定 chat.completion

creatednumber

生成时间 Unix 秒

modelstring

实际使用的模型 ID

choicesarray

生成结果,常见为视频链接或任务信息

indexnumber

index

messageobject

message

rolestring

role

contentstring

内容

finish_reasonstring

finish_reason

usageobject

官方用量在 prompt_tokens / completion_tokens / total_tokens。本站计费在 usage.apizero.billing

apizeroobject

本站附加。tier 为计费档;billing 含 cost_fen / cost_yuan。未完成时还有 task_id、status=pending

request_idstring

request_id

tierstring

tier

billingobject

billing

cost_fennumber

cost_fen

cost_yuannumber

cost_yuan

{
  "id": "chatcmpl-vid",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "https://example.com/generated.mp4"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 6,
    "total_tokens": 26,
    "apizero": {
      "request_id": "mur2uu3g84c2c488",
      "tier": "economy",
      "billing": {
        "cost_fen": 40,
        "cost_yuan": 0.4
      }
    }
  }
}

模型列表

GETURL QUERY·APPLICATION/JSON

公开价目,不用 Key。筛视频用 type=video。调用仍走 /v1/chat/completions。

https://config.apizero.cn/api/v1/public/ai-models?type=video

type(类型)string选填

固定 video 只看视频模型

例video

返回结果

totalnumber

条数

modelsarray

含三档价格

idstring

id

namestring

名称

typestring

类型

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "data": {
    "total": 1,
    "models": [
      {
        "id": "viduq3",
        "name": "Vidu Q3",
        "type": "video"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快(QPS)

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
付费
QPS 限制
QPS 3
登录免费额度
无
匿名每日额度
无
黄金会员
本档不提供 VIP 额度 · QPS 10
钻石会员
本档不提供 VIP 额度 · QPS 30
企业会员
按用量扣大模型额度 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

暂无变更记录。

免责声明

生成内容由模型输出,请勿用于违法或侵权用途。