Happyhorse API 示例

Happyhorse 系列模型提供视频生成与编辑能力，支持文生视频（t2v）、图生视频（i2v）、参考视频生成（r2v）以及视频编辑（video-edit）。

基础配置

在开始调用前，请先到平台控制台创建 API Key，具体可参考创建 API Key。

请求信息

• API Base URL: https://api.agentsflare.com/v1/videos/generations
• 认证方式: Authorization: Bearer <API_KEY>
• 内容类型: application/json

请求示例

创建任务

cURL

curl -X POST "https://api.agentsflare.com/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-t2v",
    "prompt": "一只小猫在草地上奔跑，阳光洒在身上",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Python

import requests
import json

url = "https://api.agentsflare.com/v1/videos/generations"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "model": "happyhorse-1.0-t2v",
    "prompt": "一只小猫在草地上奔跑，阳光洒在身上",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
}

response = requests.post(url, headers=headers, json=payload)
result = response.json()

print("Task ID:", result.get("task_id"))

Node.js

const axios = require('axios');

const url = 'https://api.agentsflare.com/v1/videos/generations';

const payload = {
    model: 'happyhorse-1.0-t2v',
    prompt: '一只小猫在草地上奔跑，阳光洒在身上',
    duration: 5,
    resolution: '720p',
    aspect_ratio: '16:9'
};

axios.post(url, payload, {
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
})
.then(response => {
    console.log('Task ID:', response.data.task_id);
})
.catch(error => {
    console.error('Error:', error.message);
});

查询任务状态

cURL

curl -X GET "https://api.agentsflare.com/v1/async-result/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import requests

url = f"https://api.agentsflare.com/v1/async-result/{task_id}"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(url, headers=headers)
result = response.json()

print("Status:", result.get("status"))
if result.get("status") == "completed":
    print("Video URL:", result.get("video_url"))

响应示例

{
  "task_id": "hh-xxxxxxxx",
  "status": "completed",
  "video_url": "https://cdn.agentsflare.com/videos/hh-xxxxxxxx.mp4",
  "duration": 5,
  "resolution": "720p"
}

支持的模型

以下模型可通过本接口调用（按推荐程度排序）：

• happyhorse-1.0-video-edit New
• happyhorse-1.0-r2v New
• happyhorse-1.0-i2v New
• happyhorse-1.0-t2v New

💡 提示

请求示例中的 model 字段可替换为上方任意模型名称。