158 lines
5.2 KiB
Plaintext
Executable File
158 lines
5.2 KiB
Plaintext
Executable File
# SF-REF-API-MANUAL-短剧三引擎-20260715
|
||
|
||
> 朔风·短剧第1集视频生成API调用手册
|
||
> 创建时间：2026-07-15T13:52 CST
|
||
> 版本：v1.0
|
||
> 湖灯连接：待创建
|
||
|
||
---
|
||
|
||
## 一、引擎总览
|
||
|
||
| 引擎 | 类型 | 端点 | 本地令牌路径 |
|
||
|------|------|------|-------------|
|
||
| 火山方舟 | 生图/视频/LLM | `https://ark.cn-beijing.volces.com/api/v3` | `~/.guanghu-tokens/volcano-ark.token` |
|
||
| 可灵 | 视频 | `https://openapi.klingai.com` | `~/.guanghu-tokens/kling.token` |
|
||
| 万相(百炼) | 视频/图片 | `https://dashscope.aliyuncs.com` | `~/.guanghu-tokens/wanxiang.token` |
|
||
|
||
---
|
||
|
||
## 二、火山方舟（Ark）
|
||
|
||
### 2.1 生图 - 即梦3.0（Seedream 4.0）
|
||
|
||
**模型名**：`doubao-seedream-4-0-250828`
|
||
**额度**：1000张（需控制台查看余量）
|
||
**端点**：`POST https://ark.cn-beijing.volces.com/api/v3/images/generations`
|
||
|
||
```bash
|
||
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/images/generations" \
|
||
-H "Authorization: Bearer $(cat ~/.guanghu-tokens/volcano-ark.token)" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"model": "doubao-seedream-4-0-250828",
|
||
"prompt": "古风仙侠，一位白发老者站在山巅，衣袂飘飘，水墨风格",
|
||
"n": 1,
|
||
"size": "1024x1024"
|
||
}'
|
||
```
|
||
|
||
### 2.2 视频 - Seedance
|
||
|
||
| 模型 | 用途 | 价格 |
|
||
|------|------|------|
|
||
| `doubao-seedance-2-0-mini-260615` | 日常主力（便宜） | 低 |
|
||
| `doubao-seedance-2-0-260128` | 中等质量 | 中 |
|
||
| `doubao-seedance-1-0-pro-250528` | 大场景/复杂运镜 | 高 |
|
||
|
||
**端点**：`POST https://ark.cn-beijing.volces.com/api/v3/video/generations`（待确认）
|
||
|
||
### 2.3 LLM - 小云雀（Seed 2.1 Pro）
|
||
|
||
**模型名**：`doubao-seed-2-1-pro-260628`
|
||
**用途**：剧本解析、提示词优化、镜头描述生成
|
||
**端点**：`POST https://ark.cn-beijing.volces.com/api/v3/chat/completions`
|
||
|
||
```bash
|
||
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/chat/completions" \
|
||
-H "Authorization: Bearer $(cat ~/.guanghu-tokens/volcano-ark.token)" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"model": "doubao-seed-2-1-pro-260628",
|
||
"messages": [{"role": "user", "content": "解析这段剧本..."}]
|
||
}'
|
||
```
|
||
|
||
---
|
||
|
||
## 三、可灵（Kling）
|
||
|
||
### 3.1 文生视频
|
||
|
||
**模型名**：`kling-v2-5-turbo`（std模式）
|
||
**端点**：`POST https://openapi.klingai.com/v1/videos/text2video`
|
||
**查询**：`GET https://openapi.klingai.com/v1/videos/text2video/{task_id}`
|
||
**积分**：1.5积分/5秒（96→94.5，7月21日到期）
|
||
|
||
```bash
|
||
# 创建任务
|
||
curl -X POST "https://openapi.klingai.com/v1/videos/text2video" \
|
||
-H "Authorization: Bearer $(cat ~/.guanghu-tokens/kling.token)" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"model_name": "kling-v2-5-turbo",
|
||
"prompt": "写实风格，武侠打斗，刀光剑影",
|
||
"duration": "5",
|
||
"mode": "std"
|
||
}'
|
||
|
||
# 查询结果
|
||
curl -s "https://openapi.klingai.com/v1/videos/text2video/{task_id}" \
|
||
-H "Authorization: Bearer $(cat ~/.guanghu-tokens/kling.token)"
|
||
```
|
||
|
||
**返回字段**：`data.task_status`（submitted→processing→succeed），`data.task_result.videos[0].url`
|
||
|
||
---
|
||
|
||
## 四、万相 / 百炼（DashScope）
|
||
|
||
### 4.1 文生视频（Wan2.7）
|
||
|
||
**模型名**：`wan2.7-t2v-2026-06-12`
|
||
**端点**：`POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis`
|
||
**查询**：`GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}`
|
||
**协议**：异步（X-DashScope-Async: enable）
|
||
|
||
```bash
|
||
# 创建任务
|
||
curl -X POST "https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis" \
|
||
-H "X-DashScope-Async: enable" \
|
||
-H "Authorization: Bearer $(cat ~/.guanghu-tokens/wanxiang.token)" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"model": "wan2.7-t2v-2026-06-12",
|
||
"input": {"prompt": "仙侠世界，云雾缭绕的山峰，御剑飞行"},
|
||
"parameters": {"duration": 5, "resolution": "720P"}
|
||
}'
|
||
|
||
# 查询结果
|
||
curl -s "https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}" \
|
||
-H "Authorization: Bearer $(cat ~/.guanghu-tokens/wanxiang.token)"
|
||
```
|
||
|
||
**返回字段**：`output.task_status`（PENDING→RUNNING→SUCCEEDED），`output.video_url`
|
||
|
||
### 4.2 图片生成（Wan2.7）
|
||
|
||
**模型名**：`wan2.7-image` / `wan2.7-image-pro`
|
||
**端点**：`POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation`
|
||
|
||
```bash
|
||
curl -X POST "https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation" \
|
||
-H "X-DashScope-Async: enable" \
|
||
-H "Authorization: Bearer $(cat ~/.guanghu-tokens/wanxiang.token)" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"model": "wan2.7-image",
|
||
"input": {"prompt": "古风角色立绘，白衣剑客，水墨背景"}
|
||
}'
|
||
```
|
||
|
||
---
|
||
|
||
## 五、视频生成优先级策略
|
||
|
||
| 优先级 | 引擎 | 模型 | 场景 |
|
||
|--------|------|------|------|
|
||
| 1 | 可灵 | kling-v2-5-turbo | 优先消耗（7/21到期） |
|
||
| 2 | 万相 | wan2.7-t2v | 大场景/运镜 |
|
||
| 3 | 火山 | seedance-2-0-mini | 日常/便宜兜底 |
|
||
| 3 | 火山 | seedance-1-0-pro | 复杂运镜（贵） |
|
||
|
||
## 六、图片生成优先级策略
|
||
|
||
| 优先级 | 引擎 | 模型 | 额度 |
|
||
|--------|------|------|------|
|
||
| 1 | 火山 | doubao-seedream-4-0 | 即梦3.0·1000张 |
|
||
| 2 | 万相 | wan2.7-image / pro | 按量计费 | |