cicora.ai
Especificação da APIDescoberta

Modelos e catálogo

Construa a seleção de modelos com dados do catálogo, e não com uma lista fixa na aplicação.

Referência de integração: escolha os parâmetros e as capacidades disponíveis nas definições da API da sua conta e no catálogo de modelos do seu ambiente.

Ler o catálogo

O catálogo é a fonte do ID, janela de contexto, parâmetros compatíveis, modalidades e preços apresentados. Atualize-o periodicamente no seu sistema.

Para uma escolha precisa, guarde o ID do modelo juntamente com os parâmetros usados no pedido.

Catálogo de modelos
bash
curl --request GET https://cicora.ai/api/v1/models \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Accept: application/json'

Filtragem e compatibilidade

  • Filtre por modalidades de entrada e saída para texto, imagens, áudio ou vídeo.
  • Verifique supported_parameters antes de apresentar um controlo na sua interface.
  • Não transfira parâmetros de um modelo para outro apenas porque os respetivos nomes parecem semelhantes.

Preços e alterações

Calcule uma estimativa de custo a partir dos campos do catálogo e apresente a unidade junto ao número.

Considere o catálogo mutável: um modelo pode mudar, ser retirado ou adquirir outro conjunto de capacidades. Uma atualização da cache não pode quebrar o histórico guardado.