生成图片
描述画面,选择模型与画质,右侧实时跟踪任务
1
2
3
4
张并行
高级选项(负面提示词 / 种子)
个人中心
查看余额、消费记录与账号安全设置
账户信息
用户名
—
积分余额
—
注册时间
—
使用的邀请码
—
修改密码
积分流水
| 时间 | 类型 | 变动 | 余额 | 原因 |
|---|---|---|---|---|
| 加载中… | ||||
素材库
管理您的图片和音频素材,用于视频生成
加载中…
生成视频
配置参考素材与镜头描述,任务队列自动调度
创作配置
添加参考素材并描述你想要生成的视频内容
API 密钥
通过 HTTP 接口调用图片生成和视频生成,与网页共用同一账户积分
我的密钥
| 名称 | 密钥前缀 | 最后使用 | 创建时间 | 操作 |
|---|---|---|---|---|
| 加载中… | ||||
使用说明
所有请求在 HTTP Header 中加入:Authorization: Bearer ak-xxxxxxxxxxxxxxxx
图片生成
| 方法 | 端点 | 说明 |
|---|---|---|
POST | /api/images/generate | 文生图 |
POST | /api/images/edit | 图生图(需参考图) |
GET | /api/images/task/{id} | 查询图片任务状态 |
GET | /api/images/history | 图片生成历史 |
视频生成
| 方法 | 端点 | 说明 |
|---|---|---|
POST | /api/videos/reference/generate | 参考生成(支持图片/视频/音频素材) |
POST | /api/videos/first_frame/generate | 首帧生成(需上传图片,从图片生成视频) |
GET | /api/videos/task/{id} | 查询视频任务状态 |
GET | /api/videos/history | 视频生成历史(最长 180 天) |
GET | /api/videos/{id}/file | 下载生成的视频 |
Python 代码示例
import requests
API_BASE = "https://your-domain.com/api"
API_KEY = "ak-xxxxxxxxxxxxxxxx"
# ── 文生图 ──
resp = requests.post(f"{API_BASE}/images/generate",
headers={"Authorization": f"Bearer {API_KEY}"},
json={"prompt": "一只在森林里的发光水母", "size": "16:9", "quality": "2k"})
task = resp.json()
print(f"任务ID: {task['task_id']}")
# ── 查询任务 ──
import time
while True:
r = requests.get(f"{API_BASE}/images/task/{task['task_id']}",
headers={"Authorization": f"Bearer {API_KEY}"})
data = r.json()
if data["status"] == "completed":
print(f"图片URL: {data['view_url']}")
break
elif data["status"] == "failed":
print(f"失败: {data.get('error_message')}")
break
time.sleep(2)
Python 视频生成示例
import requests, time
API_BASE = "https://your-domain.com/api"
API_KEY = "ak-xxxxxxxxxxxxxxxx"
# ── 方式一:参考生成(支持图片/视频/音频素材)──
resp = requests.post(f"{API_BASE}/videos/reference/generate",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"prompt": "一只猫在草地上奔跑,阳光明媚",
"duration": 5, # 1-15 秒
"resolution": "720p", # 480p / 720p / 1080p
"aspect_ratio": "16:9" # 16:9 / 9:16 / 1:1
})
# ── 方式二:首帧生成(需先上传图片,从图片生成视频)──
# 1. 先上传参考图获取临时 URL
with open("reference.jpg", "rb") as f:
upload_resp = requests.post(f"{API_BASE}/materials/upload-temp",
headers={"Authorization": f"Bearer {API_KEY}"},
files={"file": f})
temp_url = upload_resp.json()["url"]
# 2. 提交首帧生成任务
resp = requests.post(f"{API_BASE}/videos/first_frame/generate",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"prompt": "让图片中的角色微笑并挥手",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9",
"temp_image_urls": [temp_url] # 参考图 URL(1-9 张)
})
# ── 轮询直到完成(两种方式通用)──
task = resp.json()
print(f"任务ID: {task['task_id']}")
while True:
r = requests.get(f"{API_BASE}/videos/task/{task['task_id']}",
headers={"Authorization": f"Bearer {API_KEY}"})
data = r.json()
if data["status"] == "completed":
print(f"视频URL: {data['video_url']}")
video = requests.get(data["video_url"])
with open("output.mp4", "wb") as f:
f.write(video.content)
print("视频已保存到 output.mp4")
break
elif data["status"] == "failed":
print(f"失败: {data.get('error_message')}")
break
print(f"状态: {data['status']}, 等待中...")
time.sleep(10)
cURL 示例
# 文生图
curl -X POST https://your-domain.com/api/images/generate \
-H "Authorization: Bearer ak-xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"prompt":"一只猫","size":"1:1","quality":"2k"}'
# 视频生成 - 参考生成(纯文本/图片/视频/音频素材)
curl -X POST https://your-domain.com/api/videos/reference/generate \
-H "Authorization: Bearer ak-xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"prompt":"一只猫在草地上奔跑","duration":5,"resolution":"720p","aspect_ratio":"16:9"}'
# 视频生成 - 首帧生成(需上传图片作为首帧)
curl -X POST https://your-domain.com/api/videos/first_frame/generate \
-H "Authorization: Bearer ak-xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"prompt":"让图片中的角色微笑挥手","duration":5,"resolution":"1080p","aspect_ratio":"16:9","temp_image_urls":["https://example.com/ref.jpg"]}'
# 查询任务状态
curl https://your-domain.com/api/videos/task/任务ID \
-H "Authorization: Bearer ak-xxxxxxxxxxxxxxxx"
# 查询图片任务
curl https://your-domain.com/api/images/task/任务ID \
-H "Authorization: Bearer ak-xxxxxxxxxxxxxxxx"
调用扣分规则与网页一致,请妥善保管密钥。视频生成消耗积分较高,请留意账户余额。