Skip to content

用 API 调用(图片 / 视频)

标准 OpenAI 接口格式,令牌鉴权。图片同步返回 base64;视频是异步任务(创建 → 轮询 → 下载)。

令牌分组

令牌必须属于 media / media-gen 分组,否则报「无可用渠道」。见 选择分组

图片 · 文生图

POST https://byesu.com/v1/images/generations
Authorization: Bearer sk-你的令牌
Content-Type: application/json
字段必填说明
model模型名,见 图片生成
prompt提示词
size宽x高像素,同时决定比例和分辨率档:长边 ≈1024 → 1K,≈2048 → 2K,≈3840 → 4K。如 "1024x1024"(1:1 · 1K)、"2048x1152"(16:9 · 2K)、"3840x3840"(1:1 · 4K)。不传默认 1:1 基础档
bash
curl https://byesu.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "黄昏时分,金色麦田里奔跑的金毛猎犬,电影感",
    "size": "2048x1152"
  }'

返回(图片是 PNG 的 base64):

json
{ "data": [ { "b64_json": "<base64 字符串>" } ] }

图片 · 图生图(参考图)

POST /v1/images/editsmultipart/form-data 格式,参考图作为文件上传(字段名 image,可重复传多张,每张 ≤8MB,上限因模型而异,见 图片生成):

bash
curl https://byesu.com/v1/images/edits \
  -H "Authorization: Bearer sk-你的令牌" \
  -F model="nano-banana-2" \
  -F prompt="把这张照片变成水彩画风格" \
  -F size="1024x1024" \
  -F image=@ref1.png \
  -F image=@ref2.png

返回格式与文生图相同。

视频(异步,Sora 风格)

三步:创建任务 → 轮询状态 → 下载 mp4

python
import requests, time

BASE = "https://byesu.com"
H = {"Authorization": "Bearer sk-你的令牌"}

# 1. 创建任务
task = requests.post(f"{BASE}/v1/videos", headers=H, json={
    "model": "gemini-veo31",
    "prompt": "海浪拍打礁石,慢镜头,电影感",
    "seconds": "6",           # 时长(秒),可选值因模型而异
    "size": "1280x720",       # 比例用尺寸表达;1920x1080 = 1080p(部分模型支持)
}).json()

# 2. 轮询直到完成(几十秒到几分钟)
while task["status"] not in ("completed", "failed"):
    time.sleep(5)
    task = requests.get(f"{BASE}/v1/videos/{task['id']}", headers=H).json()

# 3. 下载 mp4
if task["status"] == "completed":
    mp4 = requests.get(f"{BASE}/v1/videos/{task['id']}/content", headers=H)
    open("out.mp4", "wb").write(mp4.content)

图生视频:创建任务时改用 multipart/form-data,首帧图片放在 input_reference 文件字段(model / prompt / seconds / size 作为表单字段一起传)。runway-gen4-turbo 必须带首帧图。

视频按秒计费

视频价格 = 每秒单价 × seconds。任务失败自动退款

报错

  • 「无可用渠道」 → 令牌分组不对,见 选择分组
  • too many reference images → 参考图超过该模型上限
  • 401 / 余额不足 / 其它 → 见 常见错误 & 解决

遇到问题?联系客服或加交流群。