Static API Reference

FUN API 接口文档

面向文本、图像、视频、音频和模型管理的统一 API 文档。可通过 /api-docs.html 直接访问。

33 个接口5 个分类OpenAI 兼容AI 友好

基础地址

请求示例中的 {baseUrl} 表示当前 FUN API 服务域名。OpenAI SDK 通常配置为 {baseUrl}/v1

鉴权方式

除特别说明外,接口使用 Authorization: Bearer <token> 鉴权,并携带 Content-Type: application/json

响应格式

不同供应商接口会保留其原生字段,同时尽量提供兼容 OpenAI 的任务 ID、状态、用量和结果地址。

💬

对话补全 / 文本生成

生文

生文

对话补全

对话补全 / 文本生成

OpenAI 兼容的对话补全接口,是最主要的文本生成入口。支持流式输出、工具调用、多模态输入等。

POST/v1/chat/completions

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"deepseek-v4-pro"
messagesarray必填对话消息数组,每条包含 role 和 content[{"role":"user","content":"Hello"}]
streamboolean可选是否流式返回true
max_tokensinteger可选最大生成 token 数4096
temperaturefloat可选温度,0~2,越高越随机0.7
top_pfloat可选核采样,0~10.9
ninteger可选生成候选回复数量1
stopstring/array可选停止词"\n"
frequency_penaltyfloat可选频率惩罚,-2~20
presence_penaltyfloat可选存在惩罚,-2~20
toolsarray可选工具/函数定义列表-
tool_choicestring/object可选工具选择策略(auto/none/required)"auto"
response_formatobject可选响应格式{"type":"json_object"}
stream_optionsobject可选流式选项{"include_usage":true}
reasoning_effortstring可选推理力度(o1/o3 系列使用)"high"
seednumber可选随机种子42
userstring可选用户标识-

响应示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1700000000,
  "model": "deepseek-v4-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好!有什么可以帮助你的吗?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

适用模型

DeepSeek
deepseek-v4-flashdeepseek-v4-pro
MiniMax
MiniMax-M2.5MiniMax-M2.5-highspeedminimax-m2.7MiniMax-M2.7-highspeed
Kimi / Moonshot
kimi-k2.5kimi-k2.6
字节跳动
doubao-seed-1-6-251015doubao-seed-1-8-251228doubao-seed-2-0-code-preview-260215doubao-seed-2-0-lite-260215doubao-seed-2-0-mini-260215doubao-seed-2-0-pro-260215
智谱
glm-4.5-airglm-4.7glm-5glm-5-turboglm-5.1
腾讯混元
hunyuan-2.0-instruct-20251111hunyuan-2.0-thinking-20251109hunyuan-a13bhunyuan-t1-latestHunyuan-translationhunyuan-turbos-latest
阶跃星辰
step-2-ministep-3step-3.5-flash
阿里巴巴
qwen-flashqwen-longqwen-plusqwen-plus-2025-12-01qwen-plus-latestqwen-turboqwen3-maxqwen3-max-previewqwen3.5-flashqwen3.5-plusqwen3.6-flashqwen3.6-max-previewqwen3.6-plusqwq-plus

示例代码

curl
curl -X POST {baseUrl}/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "stream": false
  }'
python
import openai

client = openai.OpenAI(
    api_key="sk-xxx",
    base_url="{baseUrl}/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)
javascript
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-xxx',
  baseURL: '{baseUrl}/v1',
});

const response = await client.chat.completions.create({
  model: 'deepseek-v4-pro',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'Hello!' },
  ],
});
console.log(response.choices[0].message.content);
🎨

图片生成 / 编辑

生图

生图

火山引擎生图

图片生成 / 编辑

火山引擎(豆包 SeedDream)图片生成。

POST/v1/volc/images/generations

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"doubao-seedream-3-0-t2i-250415"
promptstring必填图片描述-
sizestring可选图片尺寸-
ninteger可选生成数量-

响应示例

{
  "created": 1700000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "优化后的提示词"
    }
  ]
}

适用模型

字节跳动
doubao-seedream-4-0-250828doubao-seedream-4-5-251128doubao-seedream-5-0-lite-260128

示例代码

curl
curl -X POST {baseUrl}/v1/volc/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-3-0-t2i-250415",
    "prompt": "一只可爱的猫咪坐在窗台上"
  }'
python
from openai import OpenAI

client = OpenAI(api_key="sk-xxx", base_url="{baseUrl}/v1")

response = client.images.generate(
    model="doubao-seedream-3-0-t2i-250415",
    prompt="一只可爱的猫咪坐在窗台上"
)
print(response.data[0].url)

生图

通用图片生成

图片生成 / 编辑

OpenAI 兼容的通用图片生成接口。

POST/v1/images/generations

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"qwen-image-2.0"
promptstring必填图片描述文本-
sizestring可选图片尺寸"1024x1024"
ninteger可选生成数量1
qualitystring可选图片质量。openai 模型可选:low / medium / high;其它生图模型可选:low / standard / high"low"
moderationstring可选内容审核级别"low"
backgroundstring可选背景设置"auto"
response_formatstring可选响应格式"url"

响应示例

{
  "created": 1775040508,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "优化后的提示词"
    }
  ]
}

适用模型

阿里巴巴
qwen-image-2.0qwen-image-2.0-prowan2.6-t2iwan2.7-imagewan2.7-image-pro

示例代码

curl
curl -X POST {baseUrl}/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.0",
    "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace",
    "size": "1024x1024",
    "n": 1,
    "quality": "high",
    "moderation": "low",
    "background": "auto"
  }'
python
from openai import OpenAI

client = OpenAI(api_key="sk-xxx", base_url="{baseUrl}/v1")

response = client.images.generate(
    model="qwen-image-2.0",
    prompt="A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace",
    extra_body={"size": "1024x1024", "quality": "high", "moderation": "low", "background": "auto"}
)
print(response.data[0].url)

生图

腾讯云 VOD AIGC 文生图

图片生成 / 编辑

提交腾讯云 VOD AIGC 文生图异步任务,返回任务 ID 后通过通用任务查询接口获取生成结果。

POST/v1/tenc/image/generations

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称-
promptstring必填图片描述文本-
ninteger可选生成数量,会映射到腾讯云 VOD OutputConfig.OutputImageCount1
OutputConfigobject可选腾讯云 VOD 输出配置,支持透传原生字段-
NegativePromptstring可选负面提示词-
EnhancePromptboolean可选是否增强提示词true
FileInfosarray可选参考文件信息,按腾讯云 VOD 原生格式透传-
InputRegionstring可选输入资源区域-
Seedinteger可选随机种子123

响应示例

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "model-name",
  "status": "queued",
  "progress": 0,
  "created_at": 1775040508
}

适用模型

腾讯云 VOD AIGC

示例代码

curl
curl -X POST {baseUrl}/v1/tenc/image/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "model-name",
    "prompt": "一只可爱的猫咪坐在窗台上",
    "n": 1,
    "OutputConfig": {
      "Resolution": "1K",
      "LogoAdd": "Disabled"
    },
    "Seed": 123
  }'

生图

腾讯云 VOD AIGC 查询结果

图片生成 / 编辑

查询腾讯云 VOD AIGC 文生图任务状态与生成结果。该接口复用通用异步任务查询路径。

GET/v1/video/generations/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填提交文生图任务返回的任务 ID"task_xxx"

响应示例

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxx",
    "platform": "tencent_vod",
    "action": "image_generation",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "[\"https://example.com/result-1.png\"]"
  }
}

适用模型

腾讯云 VOD AIGC

示例代码

curl
curl {baseUrl}/v1/video/generations/task_xxx \
  -H "Authorization: Bearer $API_KEY"
🎬

视频生成

生视频

生视频

Vidu 文生视频

视频生成

Vidu AI 文本生成视频接口,支持纯文本描述生成视频。

POST/v1/vidu/text2video

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"viduq2"
promptstring必填视频描述文本-
durationinteger可选视频时长(秒),默认 55
resolutionstring可选分辨率,默认 1080p"720p"
seedinteger可选随机种子,用于复现结果0
movement_amplitudestring可选运动幅度,默认 auto"auto"
bgmboolean可选是否添加背景音乐false
callback_urlstring可选任务完成后的回调地址-
payloadstring可选自定义数据,会在回调中返回-

响应示例

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "created_at": 1775027485,
  "model": "viduq2"
}

适用模型

Vidu
viduq2viduq3-turbo

示例代码

curl
curl -X POST {baseUrl}/v1/vidu/text2video \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq2",
    "prompt": "一只可爱的猫咪在草地上奔跑",
    "duration": 5
  }'

生视频

Vidu 图生视频

视频生成

Vidu AI 图片生成视频接口。支持单图生视频、首尾帧生视频(2张图)、参考图生视频(3+张图)。

POST/v1/vidu/img2video

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"viduq2-pro"
imagesarray必填图片 URL 数组。1张=图生视频,2张=首尾帧,3+张=参考图["https://..."]
promptstring可选视频描述(原生接口可选)-
durationinteger可选视频时长(秒)5
resolutionstring可选分辨率"720p"
seedinteger可选随机种子-
movement_amplitudestring可选运动幅度"auto"
bgmboolean可选是否添加背景音乐-
callback_urlstring可选回调地址-
payloadstring可选自定义数据-

响应示例

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "created_at": 1775027485,
  "model": "viduq2-pro"
}

适用模型

Vidu
viduq3-turbo

示例代码

curl
curl -X POST {baseUrl}/v1/vidu/img2video \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq2-pro",
    "images": ["https://example.com/image.jpg"],
    "prompt": "让图片中的场景动起来"
  }'

生视频

Vidu 参考图生视频

视频生成

Vidu AI 参考图生成视频接口,通过多张参考图片生成包含指定角色/场景的视频。

POST/v1/vidu/reference2video

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"viduq2-pro"
imagesarray必填参考图片 URL 数组(1-3张)["https://..."]
promptstring必填视频描述-
durationinteger可选视频时长(秒)4
resolutionstring可选分辨率"720p"
aspect_ratiostring可选画面比例"16:9"
seedinteger可选随机种子0
movement_amplitudestring可选运动幅度"auto"

响应示例

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "created_at": 1775027485,
  "model": "viduq2-pro"
}

适用模型

Vidu
viduq2-pro

示例代码

curl
curl -X POST {baseUrl}/v1/vidu/reference2video \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq2-pro",
    "images": [
      "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png",
      "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png",
      "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"
    ],
    "prompt": "Santa Claus and the bear hug by the lakeside.",
    "duration": 4,
    "seed": 0,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "movement_amplitude": "auto"
  }'

生视频

Vidu 查询结果

视频生成

查询 Vidu 视频生成任务的状态和结果。

GET/v1/vidu/tasks/{task_id}/creations

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填任务 ID(路径参数)-

响应示例

{
  "state": "success",
  "credits": 60,
  "creations": [
    {
      "id": "936823066367897600",
      "url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/...",
      "cover_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/..."
    }
  ]
}

适用模型

Vidu
所有 Vidu 模型

示例代码

curl
curl {baseUrl}/v1/vidu/tasks/task_xxx/creations \
  -H "Authorization: Bearer $API_KEY"

生视频

可灵文生视频

视频生成

可灵 AI 文本生成视频接口,支持负面提示词、镜头控制等高级功能。

POST/kling/v1/videos/text2video

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"kling-v2-6"
promptstring必填视频描述文本-
negative_promptstring可选负面提示词,描述不想要的内容-
modestring可选生成模式:std(标准)/pro(专业),默认 std"std"
durationinteger可选视频时长(秒),支持 5 或 105
aspect_ratiostring可选宽高比:1:1 / 16:9 / 9:16"16:9"
cfg_scalefloat可选提示词相关性,默认 0.50.5
callback_urlstring可选任务完成回调地址-

响应示例

{
  "code": 0,
  "message": "success",
  "task_id": "868271215092863043",
  "data": {
    "task_id": "868271215092863043",
    "task_status": "submitted",
    "created_at": 1775040508162
  }
}

适用模型

可灵
kling-v2-5-turbokling-v2-6kling-v3

示例代码

curl
curl -X POST {baseUrl}/kling/v1/videos/text2video \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-6",
    "prompt": "一只猫在花园里弹钢琴",
    "duration": 5
  }'

生视频

可灵图生视频

视频生成

可灵 AI 图片生成视频接口,支持首尾帧、静态/动态遮罩、镜头控制等高级功能。

POST/kling/v1/videos/image2video

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"kling-v2-6"
imagestring必填首帧图片 URL 或 Base64-
image_tailstring可选尾帧图片 URL 或 Base64(可选)-
promptstring可选视频描述-
negative_promptstring可选负面提示词-
modestring可选生成模式:std/pro"std"
durationinteger可选视频时长(秒),支持 5 或 105
aspect_ratiostring可选宽高比:1:1 / 16:9 / 9:16"16:9"
cfg_scalefloat可选提示词相关性0.5

响应示例

{
  "code": 0,
  "message": "success",
  "task_id": "868271215092863043",
  "data": {
    "task_id": "868271215092863043",
    "task_status": "submitted"
  }
}

适用模型

可灵
kling-v2-5-turbokling-v2-6kling-v3

示例代码

curl
curl -X POST {baseUrl}/kling/v1/videos/image2video \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-6",
    "image": "https://example.com/image.jpg",
    "prompt": "让画面动起来",
    "duration": 5
  }'

生视频

可灵 Omni 视频生成

视频生成

可灵 Omni 视频生成接口,支持多图引用与镜头指令,适用于人物/场景一致性生成。

POST/kling/v1/omni-video

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"kling-video-o1"
promptstring必填视频描述文本,可使用 <<<image_1>>> 等占位符引用图片-
image_listarray必填参考图列表,每个元素包含 image_url 字段-
durationinteger可选视频时长(秒)5
modestring可选生成模式:std/pro"pro"
aspect_ratiostring可选宽高比:1:1 / 16:9 / 9:16"16:9"
callback_urlstring可选任务完成回调地址-
external_task_idstring可选业务侧任务标识,用于链路追踪-

响应示例

{
  "id": "task_0IcOur0w9ZJ9121ob2fbsW21A6N9XzJO",
  "task_id": "task_0IcOur0w9ZJ9121ob2fbsW21A6N9XzJO",
  "object": "video",
  "model": "kling-video-o1",
  "status": "queued",
  "progress": 0,
  "created_at": 1775706945
}

适用模型

可灵
kling-video-o1kling-v3-omni

示例代码

curl
curl -X POST {baseUrl}/kling/v1/omni-video   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "kling-video-o1",
    "prompt": "让<<<image_1>>>中的人物向镜头挥手",
    "image_list": [
      {
        "image_url": "https://example.com/multi-1.png"
      }
    ],
    "duration": 5,
    "mode": "pro",
    "aspect_ratio": "16:9"
  }'

生视频

可灵查询 Omni 视频

视频生成

查询可灵 Omni 视频任务状态与结果。

GET/kling/v1/omni-video/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填任务 ID(路径参数)-

响应示例

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_0IcOur0w9ZJ9121ob2fbsW21A6N9XzJO",
    "action": "omniVideo",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://v2-fdl.kechuangai.com/...mp4"
  }
}

适用模型

可灵
kling-video-o1kling-v3-omni

示例代码

curl
curl {baseUrl}/kling/v1/omni-video/task_0IcOur0w9ZJ9121ob2fbsW21A6N9XzJO   -H "Authorization: Bearer $API_KEY"

生视频

可灵查询文生视频

视频生成

查询可灵文生视频任务的状态和结果。

GET/kling/v1/videos/text2video/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填任务 ID(路径参数)-

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "868271215092863043",
    "task_status": "succeed",
    "final_unit_deduction": "1.5",
    "task_result": {
      "videos": [
        {
          "id": "868271215227068506",
          "url": "https://v4-fdl.kechuangai.com/...",
          "duration": "5.041"
        }
      ]
    }
  }
}

适用模型

可灵
所有可灵文生视频模型

示例代码

curl
curl {baseUrl}/kling/v1/videos/text2video/868271215092863043 \
  -H "Authorization: Bearer $API_KEY"

生视频

可灵查询图生视频

视频生成

查询可灵图生视频任务的状态和结果。

GET/kling/v1/videos/image2video/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填任务 ID(路径参数)-

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "868271215092863043",
    "task_status": "succeed",
    "final_unit_deduction": "1.5",
    "task_result": {
      "videos": [
        {
          "id": "868271215227068506",
          "url": "https://v4-fdl.kechuangai.com/...",
          "duration": "5.041"
        }
      ]
    }
  }
}

适用模型

可灵
所有可灵图生视频模型

示例代码

curl
curl {baseUrl}/kling/v1/videos/image2video/868271215092863043 \
  -H "Authorization: Bearer $API_KEY"

生视频

通用视频生成

视频生成

OpenAI 兼容的通用视频生成接口。

POST/v1/video/generations

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"wan2.6-i2v"
promptstring必填视频描述文本-
imagestring可选参考图片 URL(图生视频时使用)-
durationfloat可选视频时长(秒)5.0
widthinteger可选视频宽度1280
heightinteger可选视频高度720
metadataobject可选厂商特定参数,包装原生接口的 input 和 parameters。图生视频/参考生视频需要按厂商协议放入 metadata.input,例如 happyhorse 图生视频和参考生视频使用 metadata.input.media,不要传顶层 input.media-

响应示例

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "model": "wan2.6-i2v",
  "created_at": 1775040508
}

适用模型

阿里巴巴
happyhorse-1.0-i2vhappyhorse-1.0-r2vhappyhorse-1.0-t2vwan2.7-i2v-2026-04-25wan2.7-r2vwan2.7-t2v-2026-04-25

示例代码

文生视频 curl
curl -X POST {baseUrl}/v1/video/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-t2v",
    "prompt": "一只猫在花园里弹钢琴,电影感镜头,柔和光线",
    "metadata": {
      "input": {
        "prompt": "一只猫在花园里弹钢琴,电影感镜头,柔和光线"
      },
      "parameters": {
        "resolution": "720P",
        "duration": 5
      }
    }
  }'
图生视频 curl
curl -X POST {baseUrl}/v1/video/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-i2v",
    "prompt": "一只猫在花园里弹钢琴,另外一只毛色与之相反的猫在抓蝴蝶",
    "metadata": {
      "input": {
        "media": [
          {
            "type": "first_frame",
            "url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
          }
        ]
      },
      "parameters": {
        "resolution": "720P",
        "duration": 5
      }
    }
  }'
参考生视频 curl
curl -X POST {baseUrl}/v1/video/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-r2v",
    "prompt": "参考视频的镜头运动和主体动作,生成一段风格一致的新视频",
    "metadata": {
      "input": {
        "media": [
          {
            "type": "reference_video",
            "url": "https://example.com/reference.mp4"
          }
        ]
      },
      "parameters": {
        "resolution": "720P",
        "duration": 5
      }
    }
  }'

生视频

通用视频查询

视频生成

查询任何视频生成任务的状态和结果。别名接口:GET /v1/videos/{task_id}

GET/v1/video/generations/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填任务 ID(路径参数)-

响应示例

{
  "id": "task_xxx",
  "status": "succeeded",
  "model": "wan2.6-i2v",
  "created_at": 1775040508,
  "completed_at": 1775040597,
  "progress": "100%",
  "metadata": {
    "url": "https://..."
  }
}

适用模型

阿里巴巴
happyhorse-1.0-i2vhappyhorse-1.0-r2vhappyhorse-1.0-t2vwan2.7-i2v-2026-04-25wan2.7-r2vwan2.7-t2v-2026-04-25

示例代码

curl
curl {baseUrl}/v1/video/generations/task_xxx \
  -H "Authorization: Bearer $API_KEY"

生视频

火山引擎视频生成

视频生成

火山引擎 Seedance 视频生成接口。

POST/v1/volc/videos/generations

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"doubao-seedance-2-0-260128"
contentarray必填多模态内容数组,支持 text / image_url / video_url / audio_url-
generate_audioboolean可选是否生成音频-
ratiostring可选画面比例,如 "16:9"-
resolutionstring可选分辨率,如 "1080p"-
durationinteger可选时长(秒)-
watermarkboolean可选是否添加水印-

响应示例

{
  "id": "volc-xxx",
  "object": "video",
  "status": "queued",
  "created_at": 1700000000
}

适用模型

字节跳动
doubao-seedance-1-0-pro-250528doubao-seedance-1-0-pro-fast-251015doubao-seedance-1-5-pro-251215doubao-seedance-2-0-260128doubao-seedance-2-0-fast-260128

示例代码

curl

curl -X POST {baseUrl}/v1/volc/videos/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg" },
        "role": "reference_image"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg" },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4" },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3" },
        "role": "reference_audio"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "resolution": "1080p",
    "duration": 11,
    "watermark": false
  }'

生视频

火山引擎查询视频

视频生成

查询火山引擎 Seedance 视频生成任务状态和结果。

GET/v1/volc/videos/generations/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填任务 ID-

响应示例

{
  "id": "volc-xxx",
  "object": "video",
  "model": "doubao-seedance-1-0-pro-fast-251015",
  "status": "completed",
  "progress": 100,
  "created_at": 1700000000,
  "completed_at": 1700000060
}

适用模型

字节跳动
doubao-seedance-1-0-pro-250528doubao-seedance-1-0-pro-fast-251015doubao-seedance-1-5-pro-251215doubao-seedance-2-0-260128doubao-seedance-2-0-fast-260128

示例代码

curl
curl {baseUrl}/v1/volc/videos/generations/task_xxx \
  -H "Authorization: Bearer $API_KEY"

生视频

SkyReels 文生视频

视频生成

SkyReels 文本生成视频接口,支持纯文本描述生成视频。

POST/v1/skyreels/text2video

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"skyreels-v4"
promptstring必填视频描述文本-
aspect_ratiostring可选视频宽高比"16:9"
resolutionstring可选视频分辨率,支持 "480p"、"720p"、"1080p""1080p"
durationinteger可选视频时长(秒)5
soundboolean可选是否生成音频false
modestring可选生成模式"std"

响应示例

{
  "task_id": "text2video-20260416-787f381b-2777-4da2-83d4-8fdffc8ff738",
  "status": "submitted",
  "code": 200,
  "msg": "Task submitted successfully"
}

适用模型

SkyReels
skyreels-v4

示例代码

curl
curl -X POST {baseUrl}/v1/skyreels/text2video \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "skyreels-v4",
    "prompt": "A serene forest scene at sunset",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

生视频

SkyReels 查询视频任务

视频生成

查询 SkyReels 视频生成任务的状态和结果。

GET/v1/skyreels/video/task/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填任务 ID(路径参数)-

响应示例

{
  "task_id": "text2video-20260416-787f381b-2777-4da2-83d4-8fdffc8ff738",
  "code": 200,
  "status": "success",
  "data": {
    "video_url": "https://example.com/result.mp4",
    "resolution": "1080p",
    "duration": 5,
    "cost_credits": 60
  }
}

适用模型

SkyReels
skyreels-v4

示例代码

curl
curl {baseUrl}/v1/skyreels/video/task/text2video-20260416-787f381b-2777-4da2-83d4-8fdffc8ff738 \
  -H "Authorization: Bearer $API_KEY"
🎧

语音合成 / 音频生成

生音频

生音频

MiniMax 同步语音合成(短文本)

语音合成 / 音频生成

MiniMax TTS 同步接口,适合短文本快速返回音频内容。

POST/v1/minimax/tts

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"speech-2.8-hd"
textstring必填待合成文本-
streamboolean可选是否流式返回,默认 falsefalse
voice_settingobject必填音色配置对象-
voice_setting.voice_idstring必填音色 ID"male-qn-qingse"
voice_setting.speedfloat可选语速,默认 1.01
voice_setting.volfloat可选音量,默认 1.01
voice_setting.pitchfloat可选音高,默认 00
voice_setting.emotionstring可选情感风格"happy"
audio_settingobject可选输出音频配置-
audio_setting.sample_rateinteger可选采样率32000
audio_setting.bitrateinteger可选比特率128000
audio_setting.formatstring可选音频格式"mp3"
audio_setting.channelinteger可选声道数1
pronunciation_dictobject可选发音词典配置-
pronunciation_dict.tonearray可选发音纠正列表-
subtitle_enableboolean可选是否启用字幕信息false

响应示例

{
  "data": {
    "audio": "<hex-audio-bytes>",
    "status": 2,
    "ced": ""
  },
  "extra_info": {
    "audio_length": 2808,
    "audio_sample_rate": 32000,
    "audio_size": 46644,
    "bitrate": 128000,
    "word_count": 11,
    "usage_characters": 21,
    "audio_format": "mp3",
    "audio_channel": 1
  },
  "trace_id": "062517835bea1b07a75e19854da07ef3",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

适用模型

MiniMax
speech-2.8-hdspeech-2.6-hdspeech-2.8-turbospeech-2.6-turbospeech-02-hdspeech-02-turbo

示例代码

curl
curl -X POST {baseUrl}/v1/minimax/tts   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "speech-2.8-hd",
    "text": "今天是不是很开心呀(laughs),当然了!",
    "stream": false,
    "voice_setting": {
      "voice_id": "male-qn-qingse",
      "speed": 1,
      "vol": 1,
      "pitch": 0,
      "emotion": "happy"
    },
    "audio_setting": {
      "sample_rate": 32000,
      "bitrate": 128000,
      "format": "mp3",
      "channel": 1
    },
    "pronunciation_dict": {
      "tone": [
        "处理/(chu3)(li3)",
        "危险/dangerous"
      ]
    },
    "subtitle_enable": false
  }'

生音频

MiniMax 异步语音合成(长文本)

语音合成 / 音频生成

MiniMax TTS 异步接口,适合长文本或批量任务。

POST/v1/minimax/tts/async

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"speech-2.8-hd"
textstring必填待合成长文本-
voice_settingobject必填音色配置对象-
voice_setting.voice_idstring必填音色 ID"audiobook_male_1"
voice_setting.speedfloat可选语速,默认 1.01
voice_setting.volfloat可选音量,默认 1.01
voice_setting.pitchfloat可选音高,默认 01
audio_settingobject可选输出音频配置-
audio_setting.audio_sample_rateinteger可选采样率32000
audio_setting.bitrateinteger可选比特率128000
audio_setting.formatstring可选音频格式"mp3"
audio_setting.channelinteger可选声道数2
pronunciation_dictobject可选发音词典配置-
pronunciation_dict.tonearray可选发音纠正列表-
language_booststring可选语言增强策略"auto"
voice_modifyobject可选声音修饰配置-
voice_modify.pitchfloat可选修饰音高0
voice_modify.intensityfloat可选修饰强度0
voice_modify.timbrefloat可选音色修饰强度0
voice_modify.sound_effectsstring可选音效类型"spacious_echo"

响应示例

{
  "id": "task_498VlS8sjRsnB3uQypLkdbu37QgaGdi7",
  "task_id": "task_498VlS8sjRsnB3uQypLkdbu37QgaGdi7",
  "object": "video",
  "model": "speech-2.8-hd",
  "status": "queued",
  "progress": 0,
  "created_at": 0
}

适用模型

MiniMax
speech-2.8-hdspeech-2.6-hdspeech-2.8-turbospeech-2.6-turbospeech-02-hdspeech-02-turbo

示例代码

curl
curl -X POST {baseUrl}/v1/minimax/tts/async   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "speech-2.8-hd",
    "text": "真正的危险不是计算机开始像人一样思考(sighs),而是人开始像计算机一样思考。计算机只是可以帮我们处理一些简单事务。",
    "voice_setting": {
      "voice_id": "audiobook_male_1",
      "speed": 1,
      "vol": 1,
      "pitch": 1
    },
    "audio_setting": {
      "audio_sample_rate": 32000,
      "bitrate": 128000,
      "format": "mp3",
      "channel": 2
    },
    "pronunciation_dict": {
      "tone": [
        "危险/dangerous"
      ]
    },
    "language_boost": "auto",
    "voice_modify": {
      "pitch": 0,
      "intensity": 0,
      "timbre": 0,
      "sound_effects": "spacious_echo"
    }
  }'

生音频

MiniMax 查询语音合成任务

语音合成 / 音频生成

查询 MiniMax 异步语音合成任务状态、配额消耗与结果下载地址。

GET/v1/minimax/tts/tasks/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填任务 ID(路径参数)-

响应示例

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_4nDsq82D7DNhaMhZfzJUJADt6d3nSt2D",
    "platform": "minimax_tts",
    "action": "tts",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://minimax-algeng-chat-tts.oss-cn-wulanchabu.aliyuncs.com/...tar"
  }
}

适用模型

MiniMax
speech-2.8-hdspeech-2.6-hdspeech-2.8-turbospeech-2.6-turbospeech-02-hdspeech-02-turbo

示例代码

curl
curl {baseUrl}/v1/minimax/tts/tasks/task_4nDsq82D7DNhaMhZfzJUJADt6d3nSt2D   -H "Authorization: Bearer $API_KEY"

生音频

MiniMax 音乐生成

语音合成 / 音频生成

提交 MiniMax 音乐生成任务,支持通过文本提示词和歌词控制音乐创作,返回音频内容。

POST/v1/minimax/music_generate

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"music-2.6"
promptstring可选文本提示词,描述音乐风格、情绪、乐器等"独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆"
lyricsstring可选歌词文本,支持带段落标记(如 [verse]、[chorus])的结构化歌词"[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步"
audio_settingobject可选音频输出设置-
 sample_rateinteger可选采样率(Hz)44100
 bitrateinteger可选比特率(bps)256000
 formatstring可选音频格式,支持 mp3、wav、flac、aac、pcm"mp3"
streamboolean可选是否启用流式返回,默认 falsefalse

响应说明

同步模式(stream=false):返回音频二进制数据,响应头 Content-Type 根据 audio_setting.format 自动设置。

流式模式(stream=true):返回 SSE 流式音频数据。

适用模型

MiniMax
music-2.6

示例代码

curl
curl -X POST {baseUrl}/v1/minimax/music_generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "music-2.6",
    "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆",
    "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看",
    "audio_setting": {
      "sample_rate": 44100,
      "bitrate": 256000,
      "format": "mp3"
    }
  }' \
  --output music.mp3

生音频

Mureka 歌曲生成

语音合成 / 音频生成

提交 Mureka 歌曲生成任务,可通过参考音乐、音色或旋律控制生成结果。

POST/v1/song/generate

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"mureka-7.6"
promptstring可选通过输入提示词控制音乐生成,最大1024个字符"流行摇滚,欢快,励志,钢琴,吉他"
ninteger可选生成数量,默认 2,取值范围 1-3;用于按生成数量计费2
reference_idstring可选通过参考音乐控制音乐生成,由 /v1/mureka/files API 生成(purpose: reference)。除单独此选项控制外,支持与其他控制选项的组合:reference_id + vocal_id。"file_reference_xxx"
vocal_idstring可选通过音色控制音乐生成,由 /v1/mureka/files API 生成(purpose: vocal)。除单独此选项控制外,支持与其他控制选项的组合:vocal_id + reference_id、vocal_id + prompt。"file_vocal_xxx"
melody_idstring可选通过旋律控制音乐生成,由 /v1/mureka/files API 生成(purpose: melody)。除单独此选项控制外,不支持与其他控制选项的组合。"file_melody_xxx"

响应示例

{
  "id": "task_7CNp3Y4aKq9m2H8R",
  "task_id": "task_7CNp3Y4aKq9m2H8R",
  "object": "audio",
  "model": "mureka-7.6",
  "status": "queued",
  "progress": 0,
  "created_at": 1781510400
}

适用模型

Mureka
mureka-7.6mureka-o2mureka-8mureka-9

示例代码

curl
curl -X POST {baseUrl}/v1/song/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-7.6",
    "prompt": "流行摇滚,欢快,励志,钢琴,吉他",
    "n": 2,
    "reference_id": "file_reference_xxx",
    "vocal_id": "file_vocal_xxx"
  }'

生音频

Mureka 配乐生成

语音合成 / 音频生成

提交 Mureka 配乐生成任务,适合根据文本描述生成背景音乐或氛围音乐。

POST/v1/soundtrack/generate

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"mureka-8"
promptstring可选通过输入提示词控制音乐生成,最大1024个字符"管弦乐,宏大,史诗,紧张,战斗"
ninteger可选生成数量,默认 2,取值范围 1-3;用于按生成数量计费1
image_idstring可选要生成配乐的图片 ID,由 /v1/mureka/files API 生成(purpose: soundtrack)。与 video_id 参数二选一。"file_image_xxx"
video_idstring可选要生成配乐的视频 ID,由 /v1/mureka/files API 生成(purpose: soundtrack)。与 image_id 参数二选一。"file_video_xxx"

响应示例

{
  "id": "task_4SFm8U2pN6bQ1X9K",
  "task_id": "task_4SFm8U2pN6bQ1X9K",
  "object": "audio",
  "model": "mureka-8",
  "status": "queued",
  "progress": 0,
  "created_at": 1781510400
}

适用模型

Mureka
mureka-7.6mureka-8mureka-9

示例代码

curl
curl -X POST {baseUrl}/v1/soundtrack/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-8",
    "prompt": "管弦乐,宏大,史诗,紧张,战斗",
    "n": 1,
    "image_id": "file_image_xxx"
  }'

生音频

Mureka 纯音乐生成

语音合成 / 音频生成

提交 Mureka 纯音乐生成任务。纯音乐任务使用独立查询接口获取结果。

POST/v1/instrumental/generate

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
modelstring必填模型名称"mureka-9"
promptstring可选通过输入提示词控制音乐生成,最大1024个字符"钢琴独奏,舒缓,治愈,放松,冥想"
ninteger可选生成数量,默认 2,取值范围 1-3;用于按生成数量计费2
instrumental_idstring可选通过参考音乐控制纯音乐的生成,由 /v1/mureka/files API 生成(purpose: instrumental)。除单独此选项控制外,不支持与其他控制选项的组合。"file_instrumental_xxx"

响应示例

{
  "id": "task_8JHr2B6tV5wL0Q3C",
  "task_id": "task_8JHr2B6tV5wL0Q3C",
  "object": "audio",
  "model": "mureka-9",
  "status": "queued",
  "progress": 0,
  "created_at": 1781510400
}

适用模型

Mureka
mureka-7.6mureka-8mureka-9

示例代码

curl
curl -X POST {baseUrl}/v1/instrumental/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9",
    "prompt": "钢琴独奏,舒缓,治愈,放松,冥想",
    "n": 2,
    "instrumental_id": "file_instrumental_xxx"
  }'

生音频

Mureka 查询歌曲任务

语音合成 / 音频生成

查询歌曲生成或配乐生成任务状态与音频结果。

GET/v1/song/query/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填提交任务返回的任务 ID-

响应示例

{
  "id": "task_7CNp3Y4aKq9m2H8R",
  "status": "succeeded",
  "type": "audio",
  "failed_reason": "",
  "data": {
    "choices": [
      {
        "type": "audio",
        "url": "https://example.com/mureka-song-1.mp3"
      }
    ]
  }
}

适用模型

Mureka
mureka-7.6mureka-o2mureka-8mureka-9

示例代码

curl
curl {baseUrl}/v1/song/query/task_7CNp3Y4aKq9m2H8R \
  -H "Authorization: Bearer $API_KEY"

生音频

Mureka 查询纯音乐任务

语音合成 / 音频生成

查询纯音乐生成任务状态与音频结果。

GET/v1/instrumental/query/{task_id}

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
task_idpath必填提交任务返回的任务 ID-

响应示例

{
  "id": "task_8JHr2B6tV5wL0Q3C",
  "status": "succeeded",
  "type": "audio",
  "failed_reason": "",
  "data": {
    "choices": [
      {
        "type": "audio",
        "url": "https://example.com/mureka-instrumental-1.mp3"
      }
    ]
  }
}

适用模型

Mureka
mureka-7.6mureka-8mureka-9

示例代码

curl
curl {baseUrl}/v1/instrumental/query/task_8JHr2B6tV5wL0Q3C \
  -H "Authorization: Bearer $API_KEY"

生音频

Mureka 文件上传

语音合成 / 音频生成

上传 Mureka 生成任务可引用的音频文件。接口按原始请求体与 Content-Type 转发给 Mureka 文件上传接口。

POST/v1/mureka/files

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
filefile必填通过 multipart/form-data 上传的文件-
purposestring必填上传文件的预期用途。支持:
reference:支持格式 mp3、m4a,支持音频时长范围 [30,30] 秒,超出最大时长的部分会被裁剪掉。
vocal:支持格式 mp3、m4a,使用上传音频里提取的人声,支持人声时长范围 [15,30] 秒,超出最大时长的部分会被裁剪掉。
melody:支持格式 mp3、m4a、mid,使用上传音频里提取的哼唱的人声,建议上传 midi 文件,支持音频时长范围 [5,60] 秒,超出最大时长的部分会被裁剪掉。
instrumental:支持格式 mp3、m4a,支持音频时长范围 [30,30] 秒,超出最大时长的部分会被裁剪掉。
voice:支持格式 mp3、m4a,支持音频时长范围 [5,15] 秒,超出最大时长的部分会被裁剪掉。
audio:支持格式 mp3、m4a,通用的音频文件,用于歌曲续写等功能。
remix:支持格式 mp3、m4a,通用音频文件,用于混音重制(Remix)。
soundtrack:支持视频和图片。视频支持格式 .mp4、.mov、.avi、.mkv、.webm;图片支持格式 .jpg、.jpeg、.png、.webp。
lyrics-video:支持格式 .jpg、.jpeg、.png,通用的图片文件,用于歌词视频背景图。
"reference"

响应示例

{
  "id": "file_2xPq9Lw8A3",
  "object": "file",
  "purpose": "audio",
  "filename": "reference.mp3"
}

适用模型

Mureka
mureka-7.6mureka-o2mureka-8mureka-9

示例代码

curl
curl -X POST {baseUrl}/v1/mureka/files \
  -H "Authorization: Bearer $API_KEY" \
  -F "purpose=audio" \
  -F "file=@reference.mp3"
📦

模型列表 / 资产管理

其他

其他

获取模型列表

模型列表 / 资产管理

获取当前可用的模型列表。自动识别 OpenAI / Anthropic / Gemini 请求格式。

GET/v1/models

鉴权方式

Authorization: Bearer <token>

请求参数

该接口无需额外请求参数。

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "MiniMax-M2.1",
      "object": "model",
      "owned_by": "minimax"
    },
    {
      "id": "deepseek-chat",
      "object": "model",
      "owned_by": "deepseek"
    }
  ]
}

示例代码

curl
curl {baseUrl}/v1/models -H "Authorization: Bearer $API_KEY"

其他

查询令牌日志

模型列表 / 资产管理

使用 API Key 查询当前令牌的最近调用日志,支持按创建时间范围筛选。每次最多返回 1000 条,不支持分页,按原始日志 ID 倒序返回。

GET/api/log/token

鉴权方式

Authorization: Bearer <token>

请求参数

参数类型必填说明示例
start_timestamplong可选起始时间戳(秒)。传入后仅返回 created_at 大于等于该值的日志1710000000
end_timestamplong可选结束时间戳(秒)。传入后仅返回 created_at 小于等于该值的日志1710086400

响应示例

{
  "success": true,
  "message": "",
  "data": [
    {
      "id": 1,
      "created_at": 1710086400,
      "type": 2,
      "content": "请求成功",
      "username": "user@example.com",
      "token_name": "default-token",
      "model_name": "deepseek-chat",
      "quota": 1000,
      "cost": "¥1.222222",
      "prompt_tokens": 128,
      "completion_tokens": 256,
      "use_time": 2,
      "is_stream": false,
      "channel_name": "",
      "group": "default",
      "ip": "127.0.0.1"
    }
  ],
  "last_time": 1710086400
}

示例代码

curl
curl "{baseUrl}/api/log/token?start_timestamp=1710000000&end_timestamp=1710086400"   -H "Authorization: Bearer $API_KEY"

其他

账户账单汇总

模型列表 / 资产管理

后台统计接口,按日期和用户或企业条件汇总充值、消耗和当前余额。

GET/api/data/stats/account-billing-summary

鉴权方式

管理员及以上

请求参数

参数类型必填说明示例
datestring必填统计日期,格式 YYYY-MM-DD,范围为当天 00:00:00 到次日 00:00:002026-03-04
user_idinteger可选用户 ID,优先于 username123
usernamestring可选用户名,非邮箱alice
comp_idinteger可选公司 ID;未传时通过用户当前所属企业推导456

统计规则

user_id 优先于 username;未传 user_id、username、comp_id 任一条件时报错;系统调额按净值统计,正负相加;企业充值只按 comp_id 查询,不按 user_id 过滤。

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "date": "2026-03-04",
    "user_id": 123,
    "username": "alice",
    "comp_id": 456,
    "total_recharge_quota": 3000000,
    "personal_recharge_quota": 1000000,
    "enterprise_recharge_quota": 2000000,
    "total_consume_quota": 500000,
    "personal_consume_quota": 200000,
    "enterprise_consume_quota": 300000,
    "total_balance_quota": 9000000,
    "personal_balance_quota": 1000000,
    "enterprise_balance_quota": 8000000,
    "total_recharge_display": "¥6.00",
    "personal_recharge_display": "¥2.00",
    "enterprise_recharge_display": "¥4.00",
    "total_consume_display": "¥1.00",
    "personal_consume_display": "¥0.40",
    "enterprise_consume_display": "¥0.60",
    "total_balance_display": "¥18.00",
    "personal_balance_display": "¥2.00",
    "enterprise_balance_display": "¥16.00"
  }
}

示例代码

curl
curl -G "{baseUrl}/api/data/stats/account-billing-summary" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "New-Api-User: $ADMIN_USER_ID" \
  --data-urlencode "date=2026-03-04" \
  --data-urlencode "user_id=123" \
  --data-urlencode "comp_id=456"
🏠 返回首页