Convenciones de endpoints
Starmodel expone una única pasarela compatible con OpenAI. Cada solicitud llega a una sola base URL; la ruta selecciona la capacidad y el campo model selecciona el modelo.
Base URL
https://api.starmodel.ai/v1Este es tu dominio de pasarela. Añade la ruta del endpoint indicada abajo y autentica cada solicitud con Authorization: Bearer $API_KEY.
Endpoints
| Capacidad | Método | Ruta |
|---|---|---|
| Completado de chat | POST | /v1/chat/completions |
| Anthropic messages | POST | /v1/messages |
| Responses API | POST | /v1/responses |
| Generar | POST | /v1/images/generations |
| Editar | POST | /v1/images/edits |
| Generar vídeo | POST | /v1/videos/generations |
| Voz | POST | /v1/audio/speech |
| Listar modelos | GET | /v1/models |
Síncrono vs asíncrono
Chat, messages y responses responden dentro de una sola solicitud HTTP. Con stream: true la respuesta llega como Server-Sent Events (text/event-stream), terminada por data: [DONE].
La generación de imagen, vídeo y voz es una tarea larga en el upstream, pero la pasarela sondea la tarea por ti y devuelve un resultado JSON síncrono unificado: no hay ningún task id que sondear. Aumenta el tiempo de espera del cliente para vídeo. Las solicitudes limitadas devuelven HTTP 429 con una cabecera Retry-After.
Migrar desde un proveedor directo
Los endpoints son compatibles con OpenAI, así que en la mayoría de los casos solo cambias el base_url:
- client = OpenAI(api_key=OPENAI_KEY)+ client = OpenAI(+ api_key=SEEAI_KEY,+ base_url="https://api.starmodel.ai/v1",+ )¿Usas el SDK de Anthropic? Apunta su base_url a la misma pasarela y llama a /v1/messages.