媒体 API
AnyInt 通过 OpenAI 风格视频路由、DashScope 媒体路由和提供方原生媒体路由发布媒体生成能力。这些是基于任务的媒体 API,不是聊天补全端点。
AnyInt 通过 OpenAI 风格视频路由、DashScope 媒体路由和提供方原生媒体路由发布媒体生成能力。这些不是聊天补全端点。它们有各自的请求体,视频生成路由是基于任务的。
已发布路由
| 路由 | 用途 |
|---|---|
POST /dashscope/v1/services/aigc/multimodal-generation/generation | 基于提示词的图像生成 |
POST /dashscope/v1/services/aigc/video-generation/video-synthesis | 提示词、图像和音频转视频 |
GET /dashscope/v1/tasks/{task_id} | 查询视频任务状态和结果 |
POST /openai/v1/videos | 创建 OpenAI 风格视频任务 |
GET /openai/v1/videos/{video_id} | 查询 OpenAI 风格视频任务 |
GET /openai/v1/videos/{video_id}/content | 下载已完成的视频内容 |
POST /transtreams/kling/v1/images/generations | 创建 Kling v2.1 图像任务 |
GET /transtreams/kling/v1/images/generations/{task_id} | 查询 Kling v2.1 图像任务 |
POST /transtreams/kling/v1/images/omni-image | 创建 Kling V3 Omni 图像任务 |
GET /transtreams/kling/v1/images/omni-image/{task_id} | 查询 Kling V3 Omni 图像任务 |
身份验证
Authorization: Bearer <ANYINT_API_KEY>OpenAI 风格视频路由
OpenAI 风格视频生成使用 /openai/v1/videos,并通过当前账号可用的视频模型 ID 选择模型。可用模型 ID 通过 模型 API 查询;可选字段和提供方行为请查看对应模型专页。
Kling 视频的精确示例和轮询行为见 Kling 视频。
提供方原生路由
展示名为 Kling: Image v2.1 的图像模型使用 kling-v2-1。Kling 图像任务使用 Transtreams 原生图像路由。
Kling 图像的精确示例见 图像生成。只有当你的集成需要 OpenAI 风格路由未暴露的提供方原生字段时,才使用提供方原生路由。
DashScope 图像生成
核心请求结构
| 字段 | 类型 | 必填 | 含义 | 示例 |
|---|---|---|---|---|
model | 字符串 | 是 | 当前账号可用的图像模型 ID。 | qwen-image-plus |
input.messages | 数组 | 是 | 图像请求的提示消息。 | [{"role":"user","content":[...]}] |
input.messages[].role | 字符串 | 是 | 消息角色。提示词使用 user。 | user |
input.messages[].content | 数组 | 是 | 提示文本和可选参考媒体的内容块。 | [{"text":"一张海报..."}] |
content[].text | 字符串 | 通常必填 | 描述目标图像的文本提示词。 | 一张电影感产品海报... |
content[].image | 字符串 | 否 | 所选模型支持图像输入时,用作参考的公网 HTTPS 图像 URL 或支持的图像输入。 | https://your-domain.com/ref.png |
parameters.size | 字符串 | 推荐 | 输出图像尺寸。支持值取决于所选模型。 | 1328*1328 |
parameters.negative_prompt | 字符串 | 否 | 模型应避免生成的内容。 | low quality, blurry |
parameters.prompt_extend | 布尔值 | 否 | 是否允许提供方扩展或改写提示词。 | true |
parameters.watermark | 布尔值 | 否 | 支持时是否包含提供方水印。 | false |
cURL 示例
请将媒体 URL 替换为你自己存储中可公网访问的 HTTPS 资源。
curl https://api.anyint.ai/dashscope/v1/services/aigc/multimodal-generation/generation \
-H "Authorization: Bearer $ANYINT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-plus",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"text": "一张用于 AI 音乐发布的电影感产品海报,霓虹高光,高级棚拍灯光。"
}
]
}
]
},
"parameters": {
"negative_prompt": "",
"prompt_extend": true,
"watermark": false,
"size": "1328*1328"
}
}'有用的响应字段:
| 字段 | 含义 |
|---|---|
output.choices[0].message.content[].image | 提供方返回的生成图像 URL 或图像载荷 |
usage.width | 返回时的输出宽度 |
usage.height | 返回时的输出高度 |
usage.image_count | 返回时的生成图像数量 |
DashScope 视频生成
核心请求结构
| 字段 | 类型 | 必填 | 含义 | 示例 |
|---|---|---|---|---|
model | 字符串 | 是 | 当前账号可用的视频模型 ID。 | wan2.5-i2v-preview |
input.prompt | 字符串 | 是 | 描述要生成视频的文本提示词。 | 霓虹街景,镜头缓慢移动。 |
input.img_url | 字符串 | 否 | 图生视频流程使用的公网 HTTPS 源图像 URL。 | https://your-domain.com/source-image.png |
input.audio_url | 字符串 | 否 | 所选模型支持音频引导视频时的公网 HTTPS 音频 URL。 | https://your-domain.com/source-audio.mp3 |
parameters.resolution | 字符串 | 否 | 输出分辨率。支持值取决于所选模型。 | 720P |
parameters.duration | 整数 | 否 | 目标时长,单位秒。 | 10 |
parameters.audio | 布尔值 | 否 | 支持时是否包含或使用音频。 | true |
parameters.shot_type | 字符串 | 否 | 支持时的镜头或运镜行为。 | multi |
parameters.prompt_extend | 布尔值 | 否 | 是否允许提供方扩展或改写提示词。 | true |
cURL 示例
curl https://api.anyint.ai/dashscope/v1/services/aigc/video-generation/video-synthesis \
-H "Authorization: Bearer $ANYINT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.5-i2v-preview",
"input": {
"prompt": "夜晚的铁路桥下,一个涂鸦说唱歌手活了过来,随着节拍表演。",
"img_url": "https://your-domain.com/source-image.png",
"audio_url": "https://your-domain.com/source-audio.mp3"
},
"parameters": {
"resolution": "720P",
"prompt_extend": true,
"duration": 10,
"audio": true,
"shot_type": "multi"
}
}'响应模式
这是一个基于任务的 API。响应会返回:
| 字段 | 含义 |
|---|---|
request_id | 返回时用于请求追踪的标识符 |
output.task_id | 需要保存并用于轮询的任务 ID |
output.task_status | 初始任务状态,通常是 PENDING |
metadata.provider | 返回时的提供方元数据 |
视频任务查询
当前目录中显示的任务查询路径形式为:
GET /dashscope/v1/tasks/{task_id}
Apifox 目前在示例路径中直接包含了一个示例任务 ID。请将其视为路径模板,而不是固定 ID。
查询示例
curl https://api.anyint.ai/dashscope/v1/tasks/your-task-id \
-H "Authorization: Bearer $ANYINT_API_KEY"查询响应字段
| 字段 | 含义 |
|---|---|
output.task_status | 当前任务状态 |
output.video_url | 成功后生成的视频 URL |
output.actual_prompt | 提供方扩展后实际使用的提示词 |
usage.duration | 生成时长 |
usage.video_count | 输出数量 |
在已发布的示例中,视频任务会从 PENDING 变为 SUCCEEDED.
HappyHorse 视频生成
HappyHorse 可通过与 DashScope 兼容的视频合成 API 使用。先创建视频任务,然后轮询任务端点,直到 output.task_status 变为 SUCCEEDED。使用 happyhorse-1.0-t2v 作为模型。请求可以包含提示词、源图像 URL 和源音频 URL。初始响应会返回 request_id 用于追踪,以及 output.task_id 用于结果轮询。
创建视频任务
请将媒体 URL 替换为你自己存储中可公网访问的 HTTPS 资源。
curl --location --request POST 'https://api.anyint.ai/dashscope/v1/services/aigc/video-generation/video-synthesis' \
--header "Authorization: Bearer $ANYINT_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "happyhorse-1.0-t2v",
"input": {
"prompt": "一个都市奇幻场景,电影风格。一位涂鸦绘制的少年说唱歌手从夜晚铁路桥下的混凝土墙中活了过来,表演一段快速英文说唱,并摆出一个充满活力的经典说唱姿势。唯一的音频是说唱,没有额外对白或噪音。",
"img_url": "https://your-domain.com/source-image.png",
"audio_url": "https://your-domain.com/source-audio.mp3"
},
"parameters": {
"resolution": "720P",
"prompt_extend": true,
"duration": 10,
"audio": true,
"shot_type": "multi"
}
}'响应示例:
{
"request_id": "570dd72c-52ae-9151-b819-411edf66069e",
"output": {
"task_id": "c25723f0-8f2b-401a-b843-7ae05ae4e5e3",
"task_status": "PENDING"
}
}查询生成的视频
使用上一条响应中的 output.task_id:
curl --location --request GET "https://api.anyint.ai/dashscope/v1/tasks/$TASK_ID" \
--header "Authorization: Bearer $ANYINT_API_KEY"响应示例:
{
"request_id": "1e1fb115-c22a-9769-af2c-056451a8f692",
"output": {
"task_id": "a54b0585-aa49-45be-8786-fc46414634da",
"task_status": "SUCCEEDED",
"submit_time": "2026-04-27 17:01:39.657",
"scheduled_time": "2026-04-27 17:01:39.689",
"end_time": "2026-04-27 17:07:10.758",
"orig_prompt": "一个都市奇幻场景,电影风格...",
"video_url": "https://example.com/generated-video.mp4"
},
"usage": {
"duration": 10,
"input_video_duration": 0,
"output_video_duration": 10,
"video_count": 1,
"SR": 720,
"ratio": "16:9"
}
}将 output.video_url 复制到浏览器中即可预览或下载生成的视频。视频 URL 是临时的,因此如果需要保留,请保存文件。
何时使用媒体 API,何时使用 AI Music
在以下场景使用媒体 API:
- 图像生成
- 提示词转视频
- 图像加音频转视频
使用 媒体与音乐 用于:
- 歌曲生成
- 封面工作流
- 角色形象
- 歌词
- 分轨
- 与 Suno 任务关联的音乐视频生成
常见错误
- 将 Apifox 中的示例任务 ID 视为固定路由
- 以为视频生成会在初始响应中返回最终 MP4
- 将 Gemini 的图像生成载荷直接用于 DashScope 路由