剧火 Open API 文档

curl https://api.juhuo.cn/open-api/v1/video/tasks   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

{
  "code": "200",
  "message": "Success",
  "result": { ... }
}

{
  "code": "4000",
  "message": "参数错误：duration范围为4-15"
}

curl -X POST https://api.juhuo.cn/open-api/v1/upload/presign   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"   -H "Content-Type: application/json"   -d '{
    "fileName": "scene1.png",
    "contentType": "image/png"
  }'

{
  "code": "200",
  "message": "Success",
  "result": {
    "uploadUrl": "https://oss.example.com/api/user123/upload/scene1.png?signature=xxx&expires=yyy",
    "ossKey": "api/user123/upload/scene1.png",
    "method": "PUT"
  }
}

curl -X PUT "https://oss.example.com/api/user123/upload/scene1.png?signature=xxx&expires=yyy"   -H "Content-Type: image/png"   --data-binary @./scene1.png

[
  { "name": "Image 1", "ossKey": "api/.../cat.png" },
  { "name": "Image 2", "ossKey": "api/.../room.png" }
]

curl -X POST https://api.juhuo.cn/open-api/v1/video/submit   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"   -H "Content-Type: application/json"   -d '{
    "prompt": "一只橘猫在樱花树下奔跑，阳光洒落，画面温暖治愈",
    "model": "seedance-2.0",
    "duration": 8,
    "resolution": 480,
    "aspectRatio": "16:9"
  }'

curl -X POST https://api.juhuo.cn/open-api/v1/video/submit   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"   -H "Content-Type: application/json"   -d '{
    "prompt": "<<<Image 1>>> 中的角色缓缓转身，微风吹动发丝",
    "inputImages": [
      {
        "name": "Image 1",
        "ossKey": "api/user123/upload/character.png"
      }
    ],
    "duration": 10,
    "resolution": 720,
    "aspectRatio": "9:16"
  }'

{
  "code": "200",
  "message": "Success",
  "result": {
    "taskId": "gen_abc123def456"
  }
}

curl https://api.juhuo.cn/open-api/v1/video/task/gen_abc123def456   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

{
  "code": "200",
  "message": "Success",
  "result": {
    "taskId": "gen_abc123def456",
    "status": "success",
    "outputUrl": "https://cdn.example.com/output/video.mp4?token=xxx",
    "coverUrl": "https://cdn.example.com/output/cover.jpg?token=xxx",
    "errorCode": "",
    "errorMsg": "",
    "creditCost": 1.15,
    "gmtCreate": 1712534400000
  }
}

curl "https://api.juhuo.cn/open-api/v1/video/tasks?pageNo=1&pageSize=10"   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

{
  "code": "200",
  "message": "Success",
  "result": {
    "data": [
      {
        "taskId": "gen_abc123def456",
        "status": "success",
        "outputUrl": "https://cdn.example.com/output/video.mp4?token=xxx",
        "coverUrl": "https://cdn.example.com/output/cover.jpg?token=xxx",
        "errorCode": "",
        "errorMsg": "",
        "creditCost": 1.15,
        "gmtCreate": 1712534400000
      }
    ],
    "total": 42,
    "pageNo": 1,
    "pageSize": 10
  }
}

curl https://api.juhuo.cn/open-api/v1/account/balance   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

{
  "code": "200",
  "message": "Success",
  "result": {
    "totalCredits": 10000.00,
    "usedCredits": 3250.50,
    "remainCredits": 6749.50
  }
}

{
  "code": "4000",
  "message": "duration范围为4-15"
}

{
  "code": "4403",
  "message": "未授权"
}

import requests
import time

API_BASE = "https://api.juhuo.cn"
API_KEY = "sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

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


def upload_file(file_path, file_name, content_type):
    """步骤 1：获取预签名地址并上传文件"""
    # 获取预签名上传地址
    resp = requests.post(
        f"{API_BASE}/open-api/v1/upload/presign",
        headers=headers,
        json={"fileName": file_name, "contentType": content_type},
    )
    resp.raise_for_status()
    data = resp.json()["result"]

    upload_url = data["uploadUrl"]
    oss_key = data["ossKey"]

    # 上传文件
    with open(file_path, "rb") as f:
        put_resp = requests.put(
            upload_url,
            headers={"Content-Type": content_type},
            data=f,
        )
        put_resp.raise_for_status()

    print(f"上传成功: {oss_key}")
    return oss_key


def submit_image_to_video(oss_key, image_name="Image 1"):
    """步骤 2：提交图生视频任务"""
    resp = requests.post(
        f"{API_BASE}/open-api/v1/video/submit",
        headers=headers,
        json={
            "prompt": f"<<<{image_name}>>> 中的人物缓缓转身，微风吹动发丝，电影感镜头",
            "model": "seedance-2.0",
            "duration": 8,
            "resolution": 480,
            "aspectRatio": "16:9",
            "inputImages": [{"name": image_name, "ossKey": oss_key}],
        },
    )
    resp.raise_for_status()
    task_id = resp.json()["result"]["taskId"]
    print(f"任务已提交: {task_id}")
    return task_id


def poll_task(task_id, interval=5, timeout=600):
    """步骤 3：轮询任务状态"""
    elapsed = 0
    while elapsed < timeout:
        resp = requests.get(
            f"{API_BASE}/open-api/v1/video/task/{task_id}",
            headers=headers,
        )
        resp.raise_for_status()
        task = resp.json()["result"]

        status = task["status"]
        print(f"[{elapsed}s] 状态: {status}")

        if status == "success":
            print(f"生成成功！")
            print(f"  视频地址: {task['outputUrl']}")
            print(f"  封面地址: {task['coverUrl']}")
            print(f"  消耗积分: {task['creditCost']}")
            return task

        if status == "fail":
            print(f"生成失败: [{task['errorCode']}] {task['errorMsg']}")
            return task

        time.sleep(interval)
        elapsed += interval

    print("轮询超时")
    return None


# 主流程
if __name__ == "__main__":
    # 1. 上传图片
    oss_key = upload_file("./character.png", "character.png", "image/png")

    # 2. 提交生成任务
    task_id = submit_image_to_video(oss_key)

    # 3. 轮询等待结果
    result = poll_task(task_id)

import requests
import time

API_BASE = "https://api.juhuo.cn"
API_KEY = "sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

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

# 提交文本生成视频任务
resp = requests.post(
    f"{API_BASE}/open-api/v1/video/submit",
    headers=headers,
    json={
        "prompt": "浩瀚星空下，一艘宇宙飞船缓缓驶过土星光环，镜头跟随飞船移动，画面壮观震撼",
        "model": "seedance-2.0",
        "sound": "on",
        "duration": 10,
        "resolution": 720,
        "aspectRatio": "21:9",
    },
)
resp.raise_for_status()
task_id = resp.json()["result"]["taskId"]
print(f"任务已提交: {task_id}")

# 轮询任务状态
while True:
    resp = requests.get(
        f"{API_BASE}/open-api/v1/video/task/{task_id}",
        headers=headers,
    )
    task = resp.json()["result"]
    print(f"状态: {task['status']}")

    if task["status"] == "success":
        print(f"视频地址: {task['outputUrl']}")
        break
    elif task["status"] == "fail":
        print(f"失败: {task['errorMsg']}")
        break

    time.sleep(8)

# 步骤 1：获取上传地址
curl -X POST https://api.juhuo.cn/open-api/v1/upload/presign   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"   -H "Content-Type: application/json"   -d '{"fileName": "scene.png", "contentType": "image/png"}'

# 步骤 2：上传文件（使用步骤 1 返回的 uploadUrl）
curl -X PUT "<uploadUrl>"   -H "Content-Type: image/png"   --data-binary @./scene.png

# 步骤 3：提交生成任务（使用步骤 1 返回的 ossKey）
curl -X POST https://api.juhuo.cn/open-api/v1/video/submit   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"   -H "Content-Type: application/json"   -d '{
    "prompt": "<<<Image 1>>> 中的场景逐渐活过来，花朵盛开，蝴蝶飞舞",
    "inputImages": [{"name": "Image 1", "ossKey": "<ossKey>"}],
    "duration": 8,
    "aspectRatio": "16:9"
  }'

# 步骤 4：查询任务状态（使用步骤 3 返回的 taskId）
curl https://api.juhuo.cn/open-api/v1/video/task/<taskId>   -H "Authorization: Bearer sk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"