Skip to main content
Cada modelo de Router se identifica con un ID con el formato {provider}/{model}. Usa el catálogo para encontrar ese ID y luego llama a POST /v2/models/{provider}/{model}. Lista los modelos con la misma clave API que usas para generar:
Una respuesta abreviada del catálogo:
Usa id en la ruta de invocación. El objeto billing contiene datos de facturación, no un precio. Lee facturación por rechazo de política antes de basarte en él.

​
Paginación

  • Cuando has_more es true, pasa el next_cursor devuelto como cursor. Detente cuando has_more sea false, incluso si una página anterior fue más corta de lo solicitado.
  • Trata los cursores como opacos. Codifica el valor para URL, por ejemplo con cURL --get --data-urlencode "cursor=$NEXT_CURSOR"; no calcules desplazamientos ni modifiques el cursor.
  • limit tiene un valor predeterminado de 20 y un máximo de 100. Los valores por encima del máximo se ajustan; los valores cero y negativos seleccionan el predeterminado. La respuesta informa el límite que realmente se usó.
  • Un cursor no válido devuelve 400 / invalid_input. No reinicia la lista de forma silenciosa.
  • Un cursor puede seguir siendo válido entre actualizaciones del catálogo, pero el recorrido no es una instantánea: un modelo agregado antes de tu posición actual puede no aparecer en ese recorrido.
503 / service_unavailable es temporal. Reintenta con retroceso exponencial; no lo trates como un catálogo vacío. Los métodos run del SDK llaman directamente al modelo seleccionado.

​
Leer un modelo

Obtén una entrada del catálogo directamente cuando conozcas el ID del modelo:
El endpoint de detalle de modelo evita recorrer todo el catálogo. Consulta la referencia de la API para ver todos los campos de la entrada.

​
Próximos pasos