H
HelloAPI
首页模型广场控制台文档
H
HelloAPI

统一 AI 生产力 API。一套接口覆盖对话·视频·音乐·图像·语音。

产品

  • 首页
  • 模型广场
  • 控制台

开发者

  • API 文档

法律

  • 服务条款
  • 隐私政策
  • 退款政策
  • SLA

© 2026 HONG KONG HUNTING TECHNOLOGY LIMITED. 保留所有权利。

所有系统运行正常
5 分钟集成 · 零侵入

接入 HelloAPI

对话模型 (DeepSeek 等) 完全兼容 OpenAI SDK,把官方 baseURL 换成 HelloAPI 即可;视频生成 (Seedance) 走标准的「提交任务 + 轮询结果」异步接口。

01

拿 API Key

登录控制台 → API Keys → 新建。密钥加密存储,列表上可随时一键复制到剪贴板(屏幕不展示明文)。
去创建 Key
02

改 baseURL

把 SDK 的 baseURL 改成:
https://api.helloapi.io/v1
03

发起调用

model 字段直接传官方原名:对话用 deepseek-v4-pro,视频用 seedance-2.0,无需映射或前缀。

代码示例

选你用的语言/SDK,复制即可。所有示例都跑通过验证。

base: api.helloapi.io/v1
# 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/completionsOpenAI对话补全 (DeepSeek 等所有对话模型, 兼容 OpenAI 客户端)
POST /v1/video/generationsSeedance提交视频生成任务, 返回 task_id
GET /v1/video/generations/{id}Seedance轮询任务状态 / 取视频结果
GET /v1/modelsOpenAI列出当前可用模型

Seedance 视频参数

提交 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 自动重试逻辑生效。

401Unauthorized

Authorization 头缺失或 sk-xxx 错误 / 已撤销。

解决:检查 .env 里 HELLOAPI_KEY 是否粘对了,或去控制台看 key 是否还在 active 列表。

402Insufficient balance

账户余额不足。

解决:去『账单』充值,或临时关闭该 key 的月度上限。

404model_not_found

请求的 model 当前不可用或拼写有误。

解决:去『模型广场』确认模型名,例如 deepseek-v4-pro / seedance-2.0。

429Rate limited

触发速率限制(按 key 维度)。

解决:SDK 内置指数退避即可;或在 Pro/Enterprise 计划提升 RPM 上限。

常见问题

完整密钥能再次复制吗?

可以。完整 sk-xxx 在数据库里以 AES-256-GCM 加密存储(KEK 与数据库物理隔离),控制台列表上点「复制」按钮即可写入剪贴板,屏幕上不会展示明文,避免肩窥 / 录屏 / 截图泄漏。每次复制都会记入审计日志。如果你想彻底失效一把 key,点「撤销」即可。

模型名怎么传?

直接传官方原名即可,对话用 deepseek-v4-pro / deepseek-v4-flash,视频用 seedance-2.0 / seedance-2.0-fast。HelloAPI 不做改名也不加前缀,可在『模型广场』查看当前可用的全部模型名。

视频生成是同步还是异步?

异步。先 POST /v1/video/generations 提交任务拿到 task_id,再用 GET /v1/video/generations/{id} 轮询,直到 status=succeeded 后从响应里取视频地址。计费在任务成功结算时按分辨率 / 时长 / 是否含参考视频分档一次性扣除。

视频支持图生视频吗?

支持。在 content[] 里传 role 为 reference_video 的 video_url(公网 URL 或 asset://<ID>),最多 3 个参考视频。注意 fast 版不支持 1080p。

按什么计费?

按上游官方价格 + 平台服务费实时扣费(服务费覆盖支付通道、国内增值税与合规成本,每笔明细可在控制台账单页核对)。对话按输入/输出 token 计费,视频按分辨率/时长分档计费。预付费余额扣完且未续费则 key 自动停用,月度上限可在控制台创建 key 时配置。目前以 B 端公对公打款为主,续费请联系商务。

对话支持 streaming 吗?

支持。DeepSeek 等对话模型完全透传 OpenAI 的 streaming 协议,SDK 默认行为不需要任何改动。

数据是否会被存储?

请求和响应正文不会落盘,只保留必要的用量元数据(token 数、模型、耗时等)。详见 隐私政策。

准备好接入了吗?

5 分钟跑通第一次调用, OpenAI 协议兼容, 现有 SDK 零改动。