​

AI Jobs Quickstart

​

AI就绪摘要（供人类和助手使用）

• 使用AI网关基础URL：https://livepeer.studio/api/beta/generate
• 通过以下方式认证：Authorization: Bearer <LIVEPEER_API_KEY>
• 开始使用POST /text-to-image用于简单的请求/响应模式
• 其他AI作业端点遵循相同的认证/基础URL模式
• 最终默认流程仍需要利益相关者批准

​

审查状态

​

1. 先决条件

• 一个 Livepeer API 密钥（仅限后端使用）
• curl（并可选地 jq）
• 一个已知良好的 model_id 由利益相关者批准用于用户文档

​

2. 基础 URL 和认证

• 基础 URL: https://livepeer.studio/api/beta/generate
• 认证头: Authorization: Bearer <LIVEPEER_API_KEY>

curl -sS \
  -H "Authorization: Bearer $LIVEPEER_API_KEY" \
  https://livepeer.studio/api/beta/generate/health

​

3. 提交一个 AI 任务（文本到图像启动流程）

​

示例请求体

{
  "model_id": "<MODEL_ID>",
  "prompt": "A cinematic still of a lighthouse on a rocky coast at sunrise",
  "width": 1024,
  "height": 576,
  "num_images_per_prompt": 1
}

​

示例 curl 请求

curl -sS \
  -X POST "https://livepeer.studio/api/beta/generate/text-to-image" \
  -H "Authorization: Bearer $LIVEPEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "<MODEL_ID>",
    "prompt": "A cinematic still of a lighthouse on a rocky coast at sunrise",
    "width": 1024,
    "height": 576,
    "num_images_per_prompt": 1
  }'

​

4. 读取响应

• url (生成的媒体 URL)
• seed
• nsfw

{
  "images": [
    {
      "url": "https://example-cdn/path/to/output.png",
      "seed": 123456789,
      "nsfw": false
    }
  ]
}

​

5. 故障排除

​

401 Unauthorized

• 确认 Bearer 令牌有效
• 确认标题完全匹配 Authorization: Bearer ...

​

422 Validation Error

• 检查必填字段 (model_id, prompt)
• 检查请求正文的 JSON 格式
• 检查字段类型 (width/height 应为整数)

​

500 Internal Server Error

• 重试请求
• 检查网关健康检查端点
• 如果持续存在，请收集请求ID/日志上下文并通过当前支持路径升级

​

6. 什么是“AI作业”（范围说明）

• image-to-image
• image-to-video
• upscale
• audio-to-text
• segment-anything-2
• llm
• image-to-text
• live-video-to-video
• text-to-speech

​

7. 在标记最终版本之前需要利益相关者签字确认

• 确认规范的面向用户的“AI Jobs”流程
• 确认默认的model_id以在示例中发布
• 确认应排除的任何已弃用的流程/端点
• 确认必要的注意事项（限制、模型可用性、定价、认证/注册变更）

​

8. 后续步骤

• AI API 门户
• 文本到图像端点参考
• AI 管道概述
• BYOC（自备计算）

​

标准参考（以来源为权威）

• GitHub (primary): livepeer/docs api/gateway.openapi.yaml
• GitHub (primary): livepeer/ai-runner gateway.openapi.yaml
• GitHub (primary): livepeer/ai-runner README
• DeepWiki（仅证实）：livepeer/ai-runner | DeepWiki
• 本地仓库文档引用（未经验证，直到交叉核对）：/gateways/references/api-reference/AI-API/ai，/gateways/references/api-reference/AI-API/text-to-image