基础地址
请求示例中的 {baseUrl} 表示当前 FUN API 服务域名。OpenAI SDK 通常配置为 {baseUrl}/v1。
Static API Reference
面向文本、图像、视频、音频和模型管理的统一 API 文档。可通过 /api-docs.html 直接访问。
请求示例中的 {baseUrl} 表示当前 FUN API 服务域名。OpenAI SDK 通常配置为 {baseUrl}/v1。
除特别说明外,接口使用 Authorization: Bearer <token> 鉴权,并携带 Content-Type: application/json。
不同供应商接口会保留其原生字段,同时尽量提供兼容 OpenAI 的任务 ID、状态、用量和结果地址。
对话补全 / 文本生成
生文
OpenAI 兼容的对话补全接口,是最主要的文本生成入口。支持流式输出、工具调用、多模态输入等。
/v1/chat/completionsAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "deepseek-v4-pro" |
messages | array | 必填 | 对话消息数组,每条包含 role 和 content | [{"role":"user","content":"Hello"}] |
stream | boolean | 可选 | 是否流式返回 | true |
max_tokens | integer | 可选 | 最大生成 token 数 | 4096 |
temperature | float | 可选 | 温度,0~2,越高越随机 | 0.7 |
top_p | float | 可选 | 核采样,0~1 | 0.9 |
n | integer | 可选 | 生成候选回复数量 | 1 |
stop | string/array | 可选 | 停止词 | "\n" |
frequency_penalty | float | 可选 | 频率惩罚,-2~2 | 0 |
presence_penalty | float | 可选 | 存在惩罚,-2~2 | 0 |
tools | array | 可选 | 工具/函数定义列表 | - |
tool_choice | string/object | 可选 | 工具选择策略(auto/none/required) | "auto" |
response_format | object | 可选 | 响应格式 | {"type":"json_object"} |
stream_options | object | 可选 | 流式选项 | {"include_usage":true} |
reasoning_effort | string | 可选 | 推理力度(o1/o3 系列使用) | "high" |
seed | number | 可选 | 随机种子 | 42 |
user | string | 可选 | 用户标识 | - |
{
"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-v4-flashdeepseek-v4-proMiniMax-M2.5MiniMax-M2.5-highspeedminimax-m2.7MiniMax-M2.7-highspeedkimi-k2.5kimi-k2.6doubao-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-260215glm-4.5-airglm-4.7glm-5glm-5-turboglm-5.1hunyuan-2.0-instruct-20251111hunyuan-2.0-thinking-20251109hunyuan-a13bhunyuan-t1-latestHunyuan-translationhunyuan-turbos-lateststep-2-ministep-3step-3.5-flashqwen-flashqwen-longqwen-plusqwen-plus-2025-12-01qwen-plus-latestqwen-turboqwen3-maxqwen3-max-previewqwen3.5-flashqwen3.5-plusqwen3.6-flashqwen3.6-max-previewqwen3.6-plusqwq-pluscurl -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
}'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!"}
]
)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)图片生成。
/v1/volc/images/generationsAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "doubao-seedream-3-0-t2i-250415" |
prompt | string | 必填 | 图片描述 | - |
size | string | 可选 | 图片尺寸 | - |
n | integer | 可选 | 生成数量 | - |
{
"created": 1700000000,
"data": [
{
"url": "https://...",
"revised_prompt": "优化后的提示词"
}
]
}
doubao-seedream-4-0-250828doubao-seedream-4-5-251128doubao-seedream-5-0-lite-260128curl -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": "一只可爱的猫咪坐在窗台上"
}'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 兼容的通用图片生成接口。
/v1/images/generationsAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "qwen-image-2.0" |
prompt | string | 必填 | 图片描述文本 | - |
size | string | 可选 | 图片尺寸 | "1024x1024" |
n | integer | 可选 | 生成数量 | 1 |
quality | string | 可选 | 图片质量。openai 模型可选:low / medium / high;其它生图模型可选:low / standard / high | "low" |
moderation | string | 可选 | 内容审核级别 | "low" |
background | string | 可选 | 背景设置 | "auto" |
response_format | string | 可选 | 响应格式 | "url" |
{
"created": 1775040508,
"data": [
{
"url": "https://...",
"revised_prompt": "优化后的提示词"
}
]
}
qwen-image-2.0qwen-image-2.0-prowan2.6-t2iwan2.7-imagewan2.7-image-procurl -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"
}'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 文生图异步任务,返回任务 ID 后通过通用任务查询接口获取生成结果。
/v1/tenc/image/generationsAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | - |
prompt | string | 必填 | 图片描述文本 | - |
n | integer | 可选 | 生成数量,会映射到腾讯云 VOD OutputConfig.OutputImageCount | 1 |
OutputConfig | object | 可选 | 腾讯云 VOD 输出配置,支持透传原生字段 | - |
NegativePrompt | string | 可选 | 负面提示词 | - |
EnhancePrompt | boolean | 可选 | 是否增强提示词 | true |
FileInfos | array | 可选 | 参考文件信息,按腾讯云 VOD 原生格式透传 | - |
InputRegion | string | 可选 | 输入资源区域 | - |
Seed | integer | 可选 | 随机种子 | 123 |
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "video",
"model": "model-name",
"status": "queued",
"progress": 0,
"created_at": 1775040508
}
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 文生图任务状态与生成结果。该接口复用通用异步任务查询路径。
/v1/video/generations/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 提交文生图任务返回的任务 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\"]"
}
}
curl {baseUrl}/v1/video/generations/task_xxx \
-H "Authorization: Bearer $API_KEY"视频生成
生视频
Vidu AI 文本生成视频接口,支持纯文本描述生成视频。
/v1/vidu/text2videoAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "viduq2" |
prompt | string | 必填 | 视频描述文本 | - |
duration | integer | 可选 | 视频时长(秒),默认 5 | 5 |
resolution | string | 可选 | 分辨率,默认 1080p | "720p" |
seed | integer | 可选 | 随机种子,用于复现结果 | 0 |
movement_amplitude | string | 可选 | 运动幅度,默认 auto | "auto" |
bgm | boolean | 可选 | 是否添加背景音乐 | false |
callback_url | string | 可选 | 任务完成后的回调地址 | - |
payload | string | 可选 | 自定义数据,会在回调中返回 | - |
{
"id": "task_xxx",
"task_id": "task_xxx",
"created_at": 1775027485,
"model": "viduq2"
}
viduq2viduq3-turbocurl -X POST {baseUrl}/v1/vidu/text2video \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "viduq2",
"prompt": "一只可爱的猫咪在草地上奔跑",
"duration": 5
}'生视频
Vidu AI 图片生成视频接口。支持单图生视频、首尾帧生视频(2张图)、参考图生视频(3+张图)。
/v1/vidu/img2videoAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "viduq2-pro" |
images | array | 必填 | 图片 URL 数组。1张=图生视频,2张=首尾帧,3+张=参考图 | ["https://..."] |
prompt | string | 可选 | 视频描述(原生接口可选) | - |
duration | integer | 可选 | 视频时长(秒) | 5 |
resolution | string | 可选 | 分辨率 | "720p" |
seed | integer | 可选 | 随机种子 | - |
movement_amplitude | string | 可选 | 运动幅度 | "auto" |
bgm | boolean | 可选 | 是否添加背景音乐 | - |
callback_url | string | 可选 | 回调地址 | - |
payload | string | 可选 | 自定义数据 | - |
{
"id": "task_xxx",
"task_id": "task_xxx",
"created_at": 1775027485,
"model": "viduq2-pro"
}
viduq3-turbocurl -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 AI 参考图生成视频接口,通过多张参考图片生成包含指定角色/场景的视频。
/v1/vidu/reference2videoAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "viduq2-pro" |
images | array | 必填 | 参考图片 URL 数组(1-3张) | ["https://..."] |
prompt | string | 必填 | 视频描述 | - |
duration | integer | 可选 | 视频时长(秒) | 4 |
resolution | string | 可选 | 分辨率 | "720p" |
aspect_ratio | string | 可选 | 画面比例 | "16:9" |
seed | integer | 可选 | 随机种子 | 0 |
movement_amplitude | string | 可选 | 运动幅度 | "auto" |
{
"id": "task_xxx",
"task_id": "task_xxx",
"created_at": 1775027485,
"model": "viduq2-pro"
}
viduq2-procurl -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 视频生成任务的状态和结果。
/v1/vidu/tasks/{task_id}/creationsAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 任务 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 模型curl {baseUrl}/v1/vidu/tasks/task_xxx/creations \
-H "Authorization: Bearer $API_KEY"生视频
可灵 AI 文本生成视频接口,支持负面提示词、镜头控制等高级功能。
/kling/v1/videos/text2videoAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "kling-v2-6" |
prompt | string | 必填 | 视频描述文本 | - |
negative_prompt | string | 可选 | 负面提示词,描述不想要的内容 | - |
mode | string | 可选 | 生成模式:std(标准)/pro(专业),默认 std | "std" |
duration | integer | 可选 | 视频时长(秒),支持 5 或 10 | 5 |
aspect_ratio | string | 可选 | 宽高比:1:1 / 16:9 / 9:16 | "16:9" |
cfg_scale | float | 可选 | 提示词相关性,默认 0.5 | 0.5 |
callback_url | string | 可选 | 任务完成回调地址 | - |
{
"code": 0,
"message": "success",
"task_id": "868271215092863043",
"data": {
"task_id": "868271215092863043",
"task_status": "submitted",
"created_at": 1775040508162
}
}
kling-v2-5-turbokling-v2-6kling-v3curl -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 图片生成视频接口,支持首尾帧、静态/动态遮罩、镜头控制等高级功能。
/kling/v1/videos/image2videoAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "kling-v2-6" |
image | string | 必填 | 首帧图片 URL 或 Base64 | - |
image_tail | string | 可选 | 尾帧图片 URL 或 Base64(可选) | - |
prompt | string | 可选 | 视频描述 | - |
negative_prompt | string | 可选 | 负面提示词 | - |
mode | string | 可选 | 生成模式:std/pro | "std" |
duration | integer | 可选 | 视频时长(秒),支持 5 或 10 | 5 |
aspect_ratio | string | 可选 | 宽高比:1:1 / 16:9 / 9:16 | "16:9" |
cfg_scale | float | 可选 | 提示词相关性 | 0.5 |
{
"code": 0,
"message": "success",
"task_id": "868271215092863043",
"data": {
"task_id": "868271215092863043",
"task_status": "submitted"
}
}
kling-v2-5-turbokling-v2-6kling-v3curl -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 视频生成接口,支持多图引用与镜头指令,适用于人物/场景一致性生成。
/kling/v1/omni-videoAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "kling-video-o1" |
prompt | string | 必填 | 视频描述文本,可使用 <<<image_1>>> 等占位符引用图片 | - |
image_list | array | 必填 | 参考图列表,每个元素包含 image_url 字段 | - |
duration | integer | 可选 | 视频时长(秒) | 5 |
mode | string | 可选 | 生成模式:std/pro | "pro" |
aspect_ratio | string | 可选 | 宽高比:1:1 / 16:9 / 9:16 | "16:9" |
callback_url | string | 可选 | 任务完成回调地址 | - |
external_task_id | string | 可选 | 业务侧任务标识,用于链路追踪 | - |
{
"id": "task_0IcOur0w9ZJ9121ob2fbsW21A6N9XzJO",
"task_id": "task_0IcOur0w9ZJ9121ob2fbsW21A6N9XzJO",
"object": "video",
"model": "kling-video-o1",
"status": "queued",
"progress": 0,
"created_at": 1775706945
}
kling-video-o1kling-v3-omnicurl -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 视频任务状态与结果。
/kling/v1/omni-video/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 任务 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-omnicurl {baseUrl}/kling/v1/omni-video/task_0IcOur0w9ZJ9121ob2fbsW21A6N9XzJO -H "Authorization: Bearer $API_KEY"生视频
查询可灵文生视频任务的状态和结果。
/kling/v1/videos/text2video/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 任务 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 {baseUrl}/kling/v1/videos/text2video/868271215092863043 \
-H "Authorization: Bearer $API_KEY"生视频
查询可灵图生视频任务的状态和结果。
/kling/v1/videos/image2video/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 任务 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 {baseUrl}/kling/v1/videos/image2video/868271215092863043 \
-H "Authorization: Bearer $API_KEY"生视频
OpenAI 兼容的通用视频生成接口。
/v1/video/generationsAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "wan2.6-i2v" |
prompt | string | 必填 | 视频描述文本 | - |
image | string | 可选 | 参考图片 URL(图生视频时使用) | - |
duration | float | 可选 | 视频时长(秒) | 5.0 |
width | integer | 可选 | 视频宽度 | 1280 |
height | integer | 可选 | 视频高度 | 720 |
metadata | object | 可选 | 厂商特定参数,包装原生接口的 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-25curl -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 -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 -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}
/v1/video/generations/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 任务 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-25curl {baseUrl}/v1/video/generations/task_xxx \
-H "Authorization: Bearer $API_KEY"生视频
火山引擎 Seedance 视频生成接口。
/v1/volc/videos/generationsAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "doubao-seedance-2-0-260128" |
content | array | 必填 | 多模态内容数组,支持 text / image_url / video_url / audio_url | - |
generate_audio | boolean | 可选 | 是否生成音频 | - |
ratio | string | 可选 | 画面比例,如 "16:9" | - |
resolution | string | 可选 | 分辨率,如 "1080p" | - |
duration | integer | 可选 | 时长(秒) | - |
watermark | boolean | 可选 | 是否添加水印 | - |
{
"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 -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 视频生成任务状态和结果。
/v1/volc/videos/generations/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 任务 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-260128curl {baseUrl}/v1/volc/videos/generations/task_xxx \
-H "Authorization: Bearer $API_KEY"生视频
SkyReels 文本生成视频接口,支持纯文本描述生成视频。
/v1/skyreels/text2videoAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "skyreels-v4" |
prompt | string | 必填 | 视频描述文本 | - |
aspect_ratio | string | 可选 | 视频宽高比 | "16:9" |
resolution | string | 可选 | 视频分辨率,支持 "480p"、"720p"、"1080p" | "1080p" |
duration | integer | 可选 | 视频时长(秒) | 5 |
sound | boolean | 可选 | 是否生成音频 | false |
mode | string | 可选 | 生成模式 | "std" |
{
"task_id": "text2video-20260416-787f381b-2777-4da2-83d4-8fdffc8ff738",
"status": "submitted",
"code": 200,
"msg": "Task submitted successfully"
}
skyreels-v4curl -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 视频生成任务的状态和结果。
/v1/skyreels/video/task/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 任务 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-v4curl {baseUrl}/v1/skyreels/video/task/text2video-20260416-787f381b-2777-4da2-83d4-8fdffc8ff738 \
-H "Authorization: Bearer $API_KEY"语音合成 / 音频生成
生音频
MiniMax TTS 同步接口,适合短文本快速返回音频内容。
/v1/minimax/ttsAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "speech-2.8-hd" |
text | string | 必填 | 待合成文本 | - |
stream | boolean | 可选 | 是否流式返回,默认 false | false |
voice_setting | object | 必填 | 音色配置对象 | - |
voice_setting.voice_id | string | 必填 | 音色 ID | "male-qn-qingse" |
voice_setting.speed | float | 可选 | 语速,默认 1.0 | 1 |
voice_setting.vol | float | 可选 | 音量,默认 1.0 | 1 |
voice_setting.pitch | float | 可选 | 音高,默认 0 | 0 |
voice_setting.emotion | string | 可选 | 情感风格 | "happy" |
audio_setting | object | 可选 | 输出音频配置 | - |
audio_setting.sample_rate | integer | 可选 | 采样率 | 32000 |
audio_setting.bitrate | integer | 可选 | 比特率 | 128000 |
audio_setting.format | string | 可选 | 音频格式 | "mp3" |
audio_setting.channel | integer | 可选 | 声道数 | 1 |
pronunciation_dict | object | 可选 | 发音词典配置 | - |
pronunciation_dict.tone | array | 可选 | 发音纠正列表 | - |
subtitle_enable | boolean | 可选 | 是否启用字幕信息 | 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"
}
}
speech-2.8-hdspeech-2.6-hdspeech-2.8-turbospeech-2.6-turbospeech-02-hdspeech-02-turbocurl -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 TTS 异步接口,适合长文本或批量任务。
/v1/minimax/tts/asyncAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "speech-2.8-hd" |
text | string | 必填 | 待合成长文本 | - |
voice_setting | object | 必填 | 音色配置对象 | - |
voice_setting.voice_id | string | 必填 | 音色 ID | "audiobook_male_1" |
voice_setting.speed | float | 可选 | 语速,默认 1.0 | 1 |
voice_setting.vol | float | 可选 | 音量,默认 1.0 | 1 |
voice_setting.pitch | float | 可选 | 音高,默认 0 | 1 |
audio_setting | object | 可选 | 输出音频配置 | - |
audio_setting.audio_sample_rate | integer | 可选 | 采样率 | 32000 |
audio_setting.bitrate | integer | 可选 | 比特率 | 128000 |
audio_setting.format | string | 可选 | 音频格式 | "mp3" |
audio_setting.channel | integer | 可选 | 声道数 | 2 |
pronunciation_dict | object | 可选 | 发音词典配置 | - |
pronunciation_dict.tone | array | 可选 | 发音纠正列表 | - |
language_boost | string | 可选 | 语言增强策略 | "auto" |
voice_modify | object | 可选 | 声音修饰配置 | - |
voice_modify.pitch | float | 可选 | 修饰音高 | 0 |
voice_modify.intensity | float | 可选 | 修饰强度 | 0 |
voice_modify.timbre | float | 可选 | 音色修饰强度 | 0 |
voice_modify.sound_effects | string | 可选 | 音效类型 | "spacious_echo" |
{
"id": "task_498VlS8sjRsnB3uQypLkdbu37QgaGdi7",
"task_id": "task_498VlS8sjRsnB3uQypLkdbu37QgaGdi7",
"object": "video",
"model": "speech-2.8-hd",
"status": "queued",
"progress": 0,
"created_at": 0
}
speech-2.8-hdspeech-2.6-hdspeech-2.8-turbospeech-2.6-turbospeech-02-hdspeech-02-turbocurl -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 异步语音合成任务状态、配额消耗与结果下载地址。
/v1/minimax/tts/tasks/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 任务 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"
}
}
speech-2.8-hdspeech-2.6-hdspeech-2.8-turbospeech-2.6-turbospeech-02-hdspeech-02-turbocurl {baseUrl}/v1/minimax/tts/tasks/task_4nDsq82D7DNhaMhZfzJUJADt6d3nSt2D -H "Authorization: Bearer $API_KEY"生音频
提交 MiniMax 音乐生成任务,支持通过文本提示词和歌词控制音乐创作,返回音频内容。
/v1/minimax/music_generateAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "music-2.6" |
prompt | string | 可选 | 文本提示词,描述音乐风格、情绪、乐器等 | "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" |
lyrics | string | 可选 | 歌词文本,支持带段落标记(如 [verse]、[chorus])的结构化歌词 | "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步" |
audio_setting | object | 可选 | 音频输出设置 | - |
sample_rate | integer | 可选 | 采样率(Hz) | 44100 |
bitrate | integer | 可选 | 比特率(bps) | 256000 |
format | string | 可选 | 音频格式,支持 mp3、wav、flac、aac、pcm | "mp3" |
stream | boolean | 可选 | 是否启用流式返回,默认 false | false |
同步模式(stream=false):返回音频二进制数据,响应头 Content-Type 根据 audio_setting.format 自动设置。
流式模式(stream=true):返回 SSE 流式音频数据。
music-2.6curl -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 歌曲生成任务,可通过参考音乐、音色或旋律控制生成结果。
/v1/song/generateAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "mureka-7.6" |
prompt | string | 可选 | 通过输入提示词控制音乐生成,最大1024个字符 | "流行摇滚,欢快,励志,钢琴,吉他" |
n | integer | 可选 | 生成数量,默认 2,取值范围 1-3;用于按生成数量计费 | 2 |
reference_id | string | 可选 | 通过参考音乐控制音乐生成,由 /v1/mureka/files API 生成(purpose: reference)。除单独此选项控制外,支持与其他控制选项的组合:reference_id + vocal_id。 | "file_reference_xxx" |
vocal_id | string | 可选 | 通过音色控制音乐生成,由 /v1/mureka/files API 生成(purpose: vocal)。除单独此选项控制外,支持与其他控制选项的组合:vocal_id + reference_id、vocal_id + prompt。 | "file_vocal_xxx" |
melody_id | string | 可选 | 通过旋律控制音乐生成,由 /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-7.6mureka-o2mureka-8mureka-9curl -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 配乐生成任务,适合根据文本描述生成背景音乐或氛围音乐。
/v1/soundtrack/generateAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "mureka-8" |
prompt | string | 可选 | 通过输入提示词控制音乐生成,最大1024个字符 | "管弦乐,宏大,史诗,紧张,战斗" |
n | integer | 可选 | 生成数量,默认 2,取值范围 1-3;用于按生成数量计费 | 1 |
image_id | string | 可选 | 要生成配乐的图片 ID,由 /v1/mureka/files API 生成(purpose: soundtrack)。与 video_id 参数二选一。 | "file_image_xxx" |
video_id | string | 可选 | 要生成配乐的视频 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-7.6mureka-8mureka-9curl -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 纯音乐生成任务。纯音乐任务使用独立查询接口获取结果。
/v1/instrumental/generateAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
model | string | 必填 | 模型名称 | "mureka-9" |
prompt | string | 可选 | 通过输入提示词控制音乐生成,最大1024个字符 | "钢琴独奏,舒缓,治愈,放松,冥想" |
n | integer | 可选 | 生成数量,默认 2,取值范围 1-3;用于按生成数量计费 | 2 |
instrumental_id | string | 可选 | 通过参考音乐控制纯音乐的生成,由 /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-7.6mureka-8mureka-9curl -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"
}'生音频
查询歌曲生成或配乐生成任务状态与音频结果。
/v1/song/query/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 提交任务返回的任务 ID | - |
{
"id": "task_7CNp3Y4aKq9m2H8R",
"status": "succeeded",
"type": "audio",
"failed_reason": "",
"data": {
"choices": [
{
"type": "audio",
"url": "https://example.com/mureka-song-1.mp3"
}
]
}
}
mureka-7.6mureka-o2mureka-8mureka-9curl {baseUrl}/v1/song/query/task_7CNp3Y4aKq9m2H8R \
-H "Authorization: Bearer $API_KEY"生音频
查询纯音乐生成任务状态与音频结果。
/v1/instrumental/query/{task_id}Authorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
task_id | path | 必填 | 提交任务返回的任务 ID | - |
{
"id": "task_8JHr2B6tV5wL0Q3C",
"status": "succeeded",
"type": "audio",
"failed_reason": "",
"data": {
"choices": [
{
"type": "audio",
"url": "https://example.com/mureka-instrumental-1.mp3"
}
]
}
}
mureka-7.6mureka-8mureka-9curl {baseUrl}/v1/instrumental/query/task_8JHr2B6tV5wL0Q3C \
-H "Authorization: Bearer $API_KEY"生音频
上传 Mureka 生成任务可引用的音频文件。接口按原始请求体与 Content-Type 转发给 Mureka 文件上传接口。
/v1/mureka/filesAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
file | file | 必填 | 通过 multipart/form-data 上传的文件 | - |
purpose | string | 必填 | 上传文件的预期用途。支持: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-7.6mureka-o2mureka-8mureka-9curl -X POST {baseUrl}/v1/mureka/files \
-H "Authorization: Bearer $API_KEY" \
-F "purpose=audio" \
-F "file=@reference.mp3"模型列表 / 资产管理
其他
获取当前可用的模型列表。自动识别 OpenAI / Anthropic / Gemini 请求格式。
/v1/modelsAuthorization: Bearer <token>该接口无需额外请求参数。
{
"object": "list",
"data": [
{
"id": "MiniMax-M2.1",
"object": "model",
"owned_by": "minimax"
},
{
"id": "deepseek-chat",
"object": "model",
"owned_by": "deepseek"
}
]
}
curl {baseUrl}/v1/models -H "Authorization: Bearer $API_KEY"其他
使用 API Key 查询当前令牌的最近调用日志,支持按创建时间范围筛选。每次最多返回 1000 条,不支持分页,按原始日志 ID 倒序返回。
/api/log/tokenAuthorization: Bearer <token>| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
start_timestamp | long | 可选 | 起始时间戳(秒)。传入后仅返回 created_at 大于等于该值的日志 | 1710000000 |
end_timestamp | long | 可选 | 结束时间戳(秒)。传入后仅返回 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 "{baseUrl}/api/log/token?start_timestamp=1710000000&end_timestamp=1710086400" -H "Authorization: Bearer $API_KEY"其他
后台统计接口,按日期和用户或企业条件汇总充值、消耗和当前余额。
/api/data/stats/account-billing-summary管理员及以上| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
date | string | 必填 | 统计日期,格式 YYYY-MM-DD,范围为当天 00:00:00 到次日 00:00:00 | 2026-03-04 |
user_id | integer | 可选 | 用户 ID,优先于 username | 123 |
username | string | 可选 | 用户名,非邮箱 | alice |
comp_id | integer | 可选 | 公司 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 -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"