API 接入文档

curl --fail-with-body -sS --max-time 30 \
  https://ry.live/v1/models \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}"

curl --fail-with-body -sS --max-time 120 \
  https://ry.live/v1/chat/completions \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "eliroot-v4.1-flash",
    "messages": [{"role": "user", "content": "23+19等于多少？只输出数字。"}],
    "max_tokens": 512,
    "stream": false
  }'

curl --fail-with-body -sS -N --max-time 120 \
  https://ry.live/v1/responses \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": [{
      "type": "message",
      "role": "user",
      "content": [{"type": "input_text", "text": "Reply with exactly RESPONSES_OK."}]
    }],
    "max_output_tokens": 128,
    "stream": true
  }'

curl --fail-with-body -sS --max-time 120 \
  https://ry.live/v1/messages \
  -H "x-api-key: ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "eliroot-v4.1-flash",
    "max_tokens": 512,
    "system": "请简洁回答。",
    "messages": [{"role": "user", "content": [{"type": "text", "text": "23+19等于多少？只输出数字。"}]}]
  }'

curl --fail-with-body -sS --max-time 120 \
  https://ry.live/v1/decisions \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "客户反馈被重复扣款，需要今天协助处理。",
    "questions": {
      "billing": {
        "type": "noul",
        "instructions": "这是否属于账单问题？"
      },
      "team": {
        "type": "choice",
        "instructions": "应交由哪个支持团队处理？",
        "criteria": {"billing": "付款、账单与退款", "technical": "软件故障"}
      },
      "urgency": {
        "type": "score",
        "instructions": "评估这条工单的紧急程度。",
        "criteria": ["低", "中", "高"]
      }
    }
  }'

{
  "model": "jev-1.13.0",
  "answers": {
    "billing": {"type": "noul", "noul": 0.98},
    "team": {
      "type": "choice", "choice": "billing",
      "probabilities": {"billing": 0.98, "technical": 0.02},
      "confidence": 0.86
    },
    "urgency": {
      "type": "score", "score": 1.65,
      "legend": {"0": "低", "1": "中", "2": "高"},
      "probabilities": {"0": 0.05, "1": 0.25, "2": 0.70},
      "confidence": 0.40
    }
  },
  "usage": {"input_tokens": 363, "output_tokens": 62}
}

curl --fail-with-body -sS --max-time 120 \
  https://ry.live/v1/videos \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max/text-to-video",
    "prompt": "一只白猫穿过阳光下的花园，镜头缓慢跟随，树叶轻轻摇动，背景有自然鸟鸣。",
    "seconds": 5,
    "resolution": "768P",
    "aspect_ratio": "16:9",
    "prompt_expansion_mode": "disabled"
  }'

curl --fail-with-body -sS --max-time 120 \
  https://ry.live/v1/videos \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max/image-to-video",
    "prompt": "人物缓慢转向镜头，从首帧自然过渡到尾帧，保持人物外观与场景一致。",
    "seconds": 5,
    "resolution": "768P",
    "image_url": "https://example.com/replace-with-your-first-frame.png",
    "end_image_url": "https://example.com/replace-with-your-last-frame.png",
    "prompt_expansion_mode": "disabled"
  }'

curl --fail-with-body -sS --max-time 120 \
  https://ry.live/v1/videos \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -F 'model=minimax-h3-max/image-to-video' \
  -F 'prompt=人物缓慢转向镜头，从首帧自然过渡到尾帧，保持外观一致。' \
  -F 'seconds=5' \
  -F 'resolution=768P' \
  -F 'prompt_expansion_mode=disabled' \
  -F 'image_url=@first.png;type=image/png' \
  -F 'end_image_url=@last.jpg;type=image/jpeg'

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "minimax-h3-max/text-to-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1790121600
}

curl --fail-with-body -sS --max-time 30 \
  "https://ry.live/v1/videos/${VIDEO_ID:?请先设置提交响应中的 id}" \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}"

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "minimax-h3-max/text-to-video",
  "status": "completed",
  "progress": 100,
  "created_at": 1790121600,
  "completed_at": 1790121620,
  "video": {
    "url": "https://example.com/result.mp4",
    "content_type": "video/mp4"
  }
}

curl --fail-with-body -sS --max-time 120 \
  "https://ry.live/v1/videos/${VIDEO_ID:?请先设置已完成任务的 id}/content" \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  --output h3-video.mp4.part && mv h3-video.mp4.part h3-video.mp4

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "minimax-h3-max/text-to-video",
  "status": "failed",
  "progress": 100,
  "created_at": 1790121600,
  "error": {
    "code": "video_generation_failed",
    "message": "Video generation failed"
  }
}

{
  "error": {
    "message": "duration must be an integer between 5 and 15 (request id: EXAMPLE)",
    "type": "new_api_error",
    "code": ""
  }
}

import json
import os
from pathlib import Path
import shutil
import sys
import time
from urllib.error import HTTPError, URLError
from urllib.parse import quote
from urllib.request import Request, urlopen

BASE_URL = "https://ry.live/v1/videos"
API_KEY = os.environ.get("LLMER_API_KEY", "")
if not API_KEY:
    sys.exit("请先设置 LLMER_API_KEY 环境变量")
HEADERS = {"Authorization": "Bearer " + API_KEY}
WAIT_SECONDS = 900
POLL_SECONDS = 5


def error_message(body):
    if not isinstance(body, dict):
        return str(body)
    error = body.get("error")
    if isinstance(error, dict) and error.get("message"):
        return str(error["message"])
    return str(body.get("message") or error or "未知错误")


def request_json(url, payload=None, timeout=30):
    headers = dict(HEADERS)
    data = None
    if payload is not None:
        headers["Content-Type"] = "application/json"
        data = json.dumps(payload, ensure_ascii=False).encode("utf-8")
    # 仅 payload 不为空时提交 POST；不自动重试任何请求。
    with urlopen(Request(url, data=data, headers=headers), timeout=timeout) as response:
        result = json.load(response)
    if not isinstance(result, dict):
        raise RuntimeError("响应不是 JSON 对象")
    if result.get("error") or (result.get("message") and "status" not in result):
        raise RuntimeError(error_message(result))
    return result


try:
    video_id = os.environ.get("VIDEO_ID", "").strip()
    if not video_id:
        task = request_json(BASE_URL, {
            "model": "minimax-h3-max/text-to-video",
            "prompt": "白猫穿过阳光下的花园，镜头缓慢跟随，背景有鸟鸣。",
            "seconds": 5,
            "resolution": "768P",
            "aspect_ratio": "16:9",
            "prompt_expansion_mode": "disabled",
        }, timeout=120)
        video_id = task.get("id")
        if not isinstance(video_id, str) or not video_id:
            raise RuntimeError("提交响应没有任务 id；请检查记录，勿自动重新提交")

    print("任务 ID:", video_id, flush=True)
    Path("h3-video-id.txt").write_text(video_id + "\n", encoding="utf-8")
    task_url = BASE_URL + "/" + quote(video_id, safe="")
    deadline = time.monotonic() + WAIT_SECONDS
    while True:
        remaining = deadline - time.monotonic()
        if remaining <= 0:
            raise TimeoutError("等待已达上限；设置 VIDEO_ID 为上述 ID 后可继续查询")
        task = request_json(task_url, timeout=min(30, remaining))
        status = task.get("status")
        print("状态:", status, "进度:", task.get("progress"), flush=True)
        if status == "completed":
            break
        if status == "failed":
            raise RuntimeError(error_message(task))
        if status not in {"queued", "in_progress", "unknown"}:
            raise RuntimeError("无法识别任务状态，请保留 ID 后联系支持")
        remaining = deadline - time.monotonic()
        if remaining > 0:
            time.sleep(min(POLL_SECONDS, remaining))

    # 只向本站 content 端点发送鉴权，不请求 task["video"]["url"]。
    temporary = Path("h3-video.mp4.part")
    with urlopen(Request(task_url + "/content", headers=HEADERS), timeout=120) as response:
        if response.headers.get_content_type() != "video/mp4":
            raise RuntimeError("下载响应不是 MP4；请保留任务 ID 后检查")
        with temporary.open("wb") as output:
            shutil.copyfileobj(response, output)
    temporary.replace("h3-video.mp4")
    print("已保存 h3-video.mp4")
except HTTPError as exc:
    raw = exc.read().decode("utf-8", errors="replace")
    try:
        message = error_message(json.loads(raw))
    except ValueError:
        message = raw[:500] or exc.reason
    sys.exit(f"HTTP {exc.code}: {message}；不会自动重新提交")
except (URLError, OSError, ValueError, RuntimeError) as exc:
    sys.exit(f"请求已停止：{exc}。保留已打印的 ID；POST 结果不明时不要自动重发。")

curl --fail-with-body -sS --max-time 1320 \
  https://ry.live/v1/images/generations \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "eliroot-image-2.1",
    "prompt": "一只蓝色陶瓷杯，白色背景，柔和自然光，产品摄影。",
    "size": "1024x1024",
    "n": 1,
    "quality": "auto",
    "response_format": "b64_json",
    "seed": 42
  }' \
  -o image-response.json

curl --fail-with-body -sS --max-time 1320 \
  https://ry.live/v1/images/edits \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  --form-string 'model=eliroot-image-2.1' \
  --form-string 'prompt=将图中的红色陶瓷杯改为蓝色，保留杯上的黄色星形、杯柄、构图和白色背景。' \
  --form-string 'size=1024x1024' \
  --form-string 'n=1' \
  --form-string 'response_format=b64_json' \
  --form-string 'seed=42' \
  -F 'image=@reference.png;type=image/png' \
  -o image-response.json

curl --fail-with-body -sS --max-time 1320 \
  https://ry.live/v1/images/edits \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  --form-string 'model=eliroot-image-2.1' \
  --form-string 'prompt=把图1中带黄色星星的红色陶瓷杯放在图2的蓝色盘子上，保留两件物体的颜色和形状，白色背景。' \
  --form-string 'size=1024x1024' \
  --form-string 'n=1' \
  --form-string 'response_format=b64_json' \
  -F 'image[]=@reference-1.png;type=image/png' \
  -F 'image[]=@reference-2.png;type=image/png' \
  -o image-response.json

{
  "created": 1791547200,
  "data": [
    {"b64_json": "iVBORw0KGgo...省略的PNG内容..."}
  ]
}

import base64
from contextlib import ExitStack
import os
from pathlib import Path
import sys

import requests

BASE_URL = "https://ry.live/v1"
REFERENCES = []  # 文生图；本示例仅用 PNG 参考图，如 ["reference.png"]
OUTPUT = Path("eliroot-image.png")
key = os.environ.get("LLMER_API_KEY", "").strip()
if not key:
    sys.exit("请先设置 LLMER_API_KEY 环境变量")
if OUTPUT.exists():
    sys.exit("输出文件已存在；请改名，避免覆盖")

fields = {
    "model": "eliroot-image-2.1",
    "prompt": "一只蓝色陶瓷杯，白色背景，柔和自然光，产品摄影。",
    "size": "1024x1024",
    "n": 1,
    "quality": "auto",
    "response_format": "b64_json",
    "seed": 42,
}
headers = {"Authorization": "Bearer " + key}
try:
    # 单次 POST；不配置重试，不跟随跳转携带密钥。
    with ExitStack() as stack:
        if REFERENCES:
            files = []
            for index, filename in enumerate(REFERENCES, 1):
                handle = stack.enter_context(open(filename, "rb"))
                files.append(("image[]", (f"reference-{index}.png", handle, "image/png")))
            response = requests.post(
                BASE_URL + "/images/edits", headers=headers,
                data=fields, files=files, timeout=(15, 1320), allow_redirects=False,
            )
        else:
            response = requests.post(
                BASE_URL + "/images/generations", headers=headers,
                json=fields, timeout=(15, 1320), allow_redirects=False,
            )
    if response.status_code != 200:
        request_id = response.headers.get("X-Request-ID", "未提供")[:120]
        sys.exit(f"HTTP {response.status_code}，请求 ID: {request_id}；停止，不自动重试")
    result = response.json()
    items = result.get("data")
    if not isinstance(items, list) or len(items) != 1:
        raise ValueError("响应不是一张图片")
    encoded = items[0].get("b64_json")
    if not isinstance(encoded, str) or not encoded:
        raise ValueError("响应没有 b64_json")
    raw = base64.b64decode(encoded, validate=True)
    if not raw.startswith(b"\x89PNG\r\n\x1a\n"):
        raise ValueError("解码结果不是 PNG")
    with OUTPUT.open("xb") as output:
        output.write(raw)
    print(f"已保存 {OUTPUT}，{len(raw)} 字节")
except (requests.RequestException, OSError, ValueError, TypeError, AttributeError) as exc:
    sys.exit(f"请求或保存失败（{type(exc).__name__}）；结果不明时先核对用量，不自动重试")

curl --fail-with-body -sS --max-time 300 \
  https://ry.live/v1/images/generations \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "一只蓝色陶瓷杯，白色背景，柔和自然光，产品摄影。",
    "n": 1,
    "resolution": "1k",
    "aspect_ratio": "1:1",
    "response_format": "url"
  }' -o grok-image-response.json

curl --fail-with-body -sS --max-time 300 \
  https://ry.live/v1/tasks/xai-imagine \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "一只蓝色陶瓷杯，白色背景，柔和自然光，产品摄影。",
    "n": 1,
    "resolution": "1k",
    "aspect_ratio": "1:1"
  }' -o grok-image-task.json

curl --fail-with-body -sS --max-time 120 \
  https://ry.live/v1/videos \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "海边日出，浪花轻拍沙滩，镜头缓慢向前移动。",
    "seconds": 5,
    "resolution": "480p",
    "aspect_ratio": "16:9"
  }' -o grok-video-task.json

curl --fail-with-body -sS --max-time 120 \
  https://ry.live/v1/videos \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  --form-string 'model=grok-imagine-video' \
  --form-string 'prompt=保持主体外观，镜头缓慢靠近，背景自然运动。' \
  --form-string 'seconds=5' \
  --form-string 'resolution=480p' \
  -F 'input_reference=@reference.png;type=image/png' \
  -o grok-video-task.json

curl --fail-with-body -sS --max-time 30 \
  "https://ry.live/v1/videos/${VIDEO_ID:?请先设置提交响应中的 id}" \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}"

curl --fail-with-body -sS --max-time 30 \
  "https://ry.live/v1/tasks/${TASK_ID:?请先设置本站任务 ID}" \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}"

curl --fail-with-body -sS --max-time 30 \
  "https://ry.live/v1/tasks/${TASK_ID:?请先设置本站任务 ID}/artifacts" \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -o grok-artifacts.json

ARTIFACT_KEY=$(jq -er '.artifacts[0].key' grok-artifacts.json) &&
curl --fail-with-body -sS --max-time 30 -X POST \
  "https://ry.live/v1/tasks/${TASK_ID:?请先设置本站任务 ID}/artifacts/${ARTIFACT_KEY}/download-url?disposition=attachment" \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" -d '{}' \
  -D grok-download-headers.txt -o grok-download.json -w 'HTTP %{http_code}\n'

(
  set -eu
  DOWNLOAD_URL=$(jq -er 'select(.artifact_status == "ready") | .url' grok-download.json)
  case "$DOWNLOAD_URL" in
    https://ry.live/*) ;;
    *) printf '%s\n' '下载地址不是本站 HTTPS 地址，已停止' >&2; exit 1 ;;
  esac
  OUTPUT=grok-result.bin
  test ! -e "$OUTPUT"
  test ! -e "$OUTPUT.part"
  curl --fail-with-body -sS --max-time 300 "$DOWNLOAD_URL" --output "$OUTPUT.part"
  mv -n "$OUTPUT.part" "$OUTPUT"
)

curl --fail-with-body -sS --max-time 300 \
  https://ry.live/v1/images/generations \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-flash",
    "prompt": "一只蓝色陶瓷杯，白色背景，柔和自然光，产品摄影。",
    "size": "2K",
    "n": 1,
    "response_format": "url"
  }' -o seedream-image-response.json

curl --fail-with-body -sS --max-time 120 \
  https://ry.live/v1/videos \
  -H "Authorization: Bearer ${LLMER_API_KEY:?请先设置 LLMER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "prompt": "海边日出，浪花轻拍沙滩，镜头缓慢向前移动。",
    "seconds": 5,
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9",
      "generate_audio": true
    }
  }' -o seedance-video-task.json

{
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": true,
  "content": [{
    "type": "image_url",
    "image_url": {"url": "https://example.com/replace-with-your-first-frame.png"},
    "role": "first_frame"
  }]
}