快速开始

3 分钟从注册到拿到第一个生成结果。所有模型（图片 / 视频 / 音频）都走同一套接口：提交任务 → 轮询或回调 → 取结果。

Base URL：

https://api.hiapi.ai

1. 获取 API 密钥

   在 hiapi.ai 注册，然后前往 控制台 → API 密钥 创建新密钥。建议先为测试环境单独创建一把密钥。

2. 充值余额

   前往 控制台 → 充值账单 充值余额。新账户通常会获得可用于验证流程的体验额度。

3. 创建任务

   所有模型（图片 / 视频 / 音频）统一走 POST /v1/tasks，提交即返回 taskId。

   cURL

   curl -X POST https://api.hiapi.ai/v1/tasks \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "happyhorse-1-0",
       "input": {
         "prompt": "a cyan glass data center entrance",
         "duration": 5,
         "resolution": "720p"
       }
     }'
   # => { "code": 200, "data": { "taskId": "tk-hiapi-..." } }

   Python

   import requests
   
   resp = requests.post(
       "https://api.hiapi.ai/v1/tasks",
       headers={"Authorization": "Bearer YOUR_API_KEY"},
       json={
           "model": "happyhorse-1-0",
           "input": {
               "prompt": "a cyan glass data center entrance",
               "duration": 5,
               "resolution": "720p",
           },
       },
   )
   task_id = resp.json()["data"]["taskId"]
   print(task_id)

   Node.js

   const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
     method: "POST",
     headers: {
       "Authorization": "Bearer YOUR_API_KEY",
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
       model: "happyhorse-1-0",
       input: {
         prompt: "a cyan glass data center entrance",
         duration: 5,
         resolution: "720p",
       },
     }),
   });
   const { data } = await resp.json();
   console.log(data.taskId);

   示例中的 input 字段仅作示意，每个模型接受的字段不同，以对应模型页为准。

4. 轮询获取结果

   请求 GET /v1/tasks/:id 直到 status 变为 success，再从 data.output[0].url 下载。

   curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
     -H "Authorization: Bearer YOUR_API_KEY"
   # status: queued / handling / archiving / success / fail

   生产环境建议用回调代替轮询。跑通后再把模型名和参数抽到你的应用配置中。

下一步

• 阅读认证固定密钥管理方式
• 浏览所有可用模型
• 查看 统一异步接口了解所有端点