对话模型 (DeepSeek 等) 完全兼容 OpenAI SDK,把官方 baseURL 换成 HelloAPI 即可;视频生成 (Seedance) 走标准的「提交任务 + 轮询结果」异步接口。
https://api.helloapi.io/v1选你用的语言/SDK,复制即可。所有示例都跑通过验证。
# HelloAPI 兼容 OpenAI 协议: 用官方 openai SDK, 只改 base_url 即可调 DeepSeek 等模型
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.helloapi.io/v1",
api_key=os.environ["HELLOAPI_KEY"],
)
# stream=True: 首 token 0.2~0.4s 就开始往外蹦字, 体感最快 (推荐)
stream = client.chat.completions.create(
model="deepseek-v4-flash", # 走量档, 更快更便宜
messages=[{"role": "user", "content": "用一句话介绍 HelloAPI"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="", flush=True)所有路径前缀 https://api.helloapi.io
| 端点 | 协议 | 用途 |
|---|---|---|
| POST /v1/chat/completions | OpenAI | 对话补全 (DeepSeek 等所有对话模型, 兼容 OpenAI 客户端) |
| POST /v1/video/generations | Seedance | 提交视频生成任务, 返回 task_id |
| GET /v1/video/generations/{id} | Seedance | 轮询任务状态 / 取视频结果 |
| GET /v1/models | OpenAI | 列出当前可用模型 |
提交 POST /v1/video/generations 时的请求体字段。提交为异步:成功返回 task_id,需轮询直到 status=succeeded,计费在成功结算时按 分辨率 / 时长 / 是否含参考视频分档扣费。
| 字段 | 必填 | 说明 |
|---|---|---|
| model | 是 | seedance-2.0(标准版)或 seedance-2.0-fast(快速版,不支持 1080p)。 |
| prompt | 文生视频必填 | 文本描述,最长 4000 字符。带参考视频(图生视频)时可省略。 |
| resolution | 否 | 480p / 720p / 1080p,默认 720p。 |
| duration | 否 | 视频时长,整数秒,范围 2–15。 |
| ratio | 否 | 画幅比例:16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive。 |
| content | 否 | 图生视频的参考视频数组,role=reference_video,最多 3 个。 |
图生视频:在 content[] 里传 { "role": "reference_video", "video_url": { "url": "https://..." } }(公网 URL 或 asset://<ID>,最多 3 个)。fast 版不支持 1080p。
错误体跟 OpenAI 一致,便于 SDK 自动重试逻辑生效。
Authorization 头缺失或 sk-xxx 错误 / 已撤销。
解决:检查 .env 里 HELLOAPI_KEY 是否粘对了,或去控制台看 key 是否还在 active 列表。
账户余额不足。
解决:去『账单』充值,或临时关闭该 key 的月度上限。
请求的 model 当前不可用或拼写有误。
解决:去『模型广场』确认模型名,例如 deepseek-v4-pro / seedance-2.0。
触发速率限制(按 key 维度)。
解决:SDK 内置指数退避即可;或在 Pro/Enterprise 计划提升 RPM 上限。
5 分钟跑通第一次调用, OpenAI 协议兼容, 现有 SDK 零改动。