配置文档

站点: https://soulhub.top
API Base URL: https://soulhub.top/v1
配置文档: https://soulhub.top/docs

curl https://soulhub.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"deepseek-v4-flash\",
    \"messages\": [{\"role\":\"user\",\"content\":\"你好，小火龙\"}],
    \"stream\": false
  }"

curl -X POST https://soulhub.top/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"gpt-image-2-4K-high\",
    \"prompt\": \"一只橘猫坐在窗台，阳光，写实\",
    \"size\": \"3840x2160\",
    \"n\": 1,
    \"response_format\": \"url\"
  }"

curl -X POST https://soulhub.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"gpt-image-2-4K-high\",
    \"prompt\": \"一只橘猫坐在窗台，阳光，写实\",
    \"size\": \"3840x2160\"
  }"

curl https://soulhub.top/v1/videos/task_xxx \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://soulhub.top/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"gpt-image-2-4K\",
    \"prompt\": \"严格保持参考图中人物的发型、发色、服装和配饰完全不变，将他放到黄昏雪山前，全身照\",
    \"image\": \"https://你的图床/ref.png\",
    \"size\": \"3840x2160\"
  }"

import time, requests

BASE = "https://soulhub.top/v1"
KEY = "YOUR_API_KEY"
H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

r = requests.post(f"{BASE}/videos", headers=H, json={
    "model": "gpt-image-2-4K-high",
    "prompt": "一只橘猫，阳光，写实",
    "size": "3840x2160",
}, timeout=60)
r.raise_for_status()
task_id = r.json().get("id") or r.json().get("task_id")
print("task", task_id)

while True:
    d = requests.get(f"{BASE}/videos/{task_id}", headers=H, timeout=60).json()
    print(d.get("status"), d.get("progress"))
    if d.get("status") == "completed":
        print("url", d.get("url"))
        break
    if d.get("status") == "failed":
        raise RuntimeError(d)
    time.sleep(3)

curl -X POST https://soulhub.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"seedance-2.0-720p-渠道1\",
    \"prompt\": \"图片1中的角色正面微笑，镜头缓慢推近\",
    \"image\": \"https://你的图床/参考图.jpg\",
    \"seconds\": \"5\",
    \"size\": \"16:9\"
  }"

curl https://soulhub.top/v1/videos/task_xxx \
  -H "Authorization: Bearer YOUR_API_KEY"

import time, requests

API_KEY = "YOUR_API_KEY"
BASE = "https://soulhub.top/v1"

resp = requests.post(
    f"{BASE}/videos",
    headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
    json={
        "model": "seedance-2.0-720p",
        "prompt": "图片1中的角色正面微笑，镜头缓慢推近",
        "image": "https://图床/参考图.jpg",
        "duration": 5,
        "size": "16:9",
    },
    timeout=60,
)
task_id = resp.json()["id"]
print("task:", task_id)

while True:
    d = requests.get(
        f"{BASE}/videos/{task_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
        timeout=60,
    ).json()
    print(d.get("status"), d.get("progress"))
    if d.get("status") == "completed":
        print("url:", (d.get("metadata") or {}).get("result_url"))
        break
    if d.get("status") == "failed":
        print("failed:", d.get("error"))
        break
    time.sleep(10)