​

Inicio rápido para trabajos de IA

​

Resumen listo para IA (para humanos y asistentes)

• Usa la URL base de la puerta de enlace de IA: https://livepeer.studio/api/beta/generate
• Autenticarse con Authorization: Bearer <LIVEPEER_API_KEY>
• Empieza con POST /text-to-image para un patrón de solicitud/respuesta simple
• Otros puntos finales de trabajo de IA siguen el mismo patrón de autenticación/URL base
• El flujo de la canalización predeterminada final aún requiere aprobación de los responsables

​

Estado de revisión

​

1. Requisitos previos

• Una clave de API Livepeer (solo para uso en el backend)
• curl (y opcionalmentejq)
• Un buen conocido model_id aprobado por los interesados para documentación orientada al usuario

​

2. URL base y autenticación

• URL base: https://livepeer.studio/api/beta/generate
• Encabezado de autenticación: Authorization: Bearer <LIVEPEER_API_KEY>

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

​

3. Envía un trabajo de IA (flujo de inicio de texto a imagen)

​

Cuerpo de solicitud de ejemplo

{
  "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
}

​

Solicitud curl de ejemplo

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. Leer la respuesta

• url (URL de medios generados)
• seed
• nsfw

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

​

5. Solución de problemas

​

401 Unauthorized

• Confirme que el token de portador es válido
• Confirme que el encabezado es exactamente Authorization: Bearer ...

​

422 Validation Error

• Compruebe los campos obligatorios (model_id, prompt)
• Comprobar el formato JSON del cuerpo de la solicitud
• Comprobar los tipos de campo (width/height debe ser enteros)

​

500 Internal Server Error

• Volver a intentar la solicitud
• Comprueba el punto de conexión de estado de la puerta de enlace
• Si persiste, recopila el identificador de solicitud/contenido de registro y escálalo a través del actual camino de soporte

​

6. ¿Qué se considera una “tarea de IA” (nota de alcance)

• 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. Aprobación de los interesados antes de marcar como final

• Confirmar el flujo de trabajo “AI Jobs” de cara al usuario
• Confirmar el predeterminadomodel_id para publicar en ejemplos
• Confirmar cualquier flujo/endpoint obsoleto que deba excluirse
• Confirmar las advertencias necesarias (límites, disponibilidad de modelos, precios, cambios de autenticación/registro)

​

8. Pasos siguientes

• Portal de la API de IA
• Referencia del punto de conexión de texto a imagen
• Visión general de las pipelines de IA
• BYOC (Trae tu propio cómputo)

​

Referencias canónicas (primero la fuente de verdad)

• GitHub (primario): livepeer/docs api/gateway.openapi.yaml
• GitHub (primario): livepeer/ai-runner gateway.openapi.yaml
• GitHub (primario): README de livepeer/ai-runner
• DeepWiki (solo verificación): livepeer/ai-runner | DeepWiki
• Referencias de documentación locales del repositorio (no validadas hasta que se verifiquen): /gateways/references/api-reference/AI-API/ai, /gateways/references/api-reference/AI-API/text-to-image