Modelos

Listar modelos

GET https://api.artfical.com/v1/models
Authorization: Bearer tai-sk-...

Devolve todos os modelos que a sua chave pode usar, no mesmo formato de lista que o próprio endpoint /v1/models da OpenAI usa:

{
  "object": "list",
  "data": [
    {
      "id": "tai-4.1",
      "object": "model",
      "created": 1749564000,
      "owned_by": "artfical",
      "name": "tAI 4.1",
      "description": "Our most capable model - top-tier reasoning and creativity",
      "context_length": 200000
    }
    // ...
  ]
}

Os modelos

Modelo	Posicionamento	Contexto	Imagens
tai-4.0.6P	Rápido, leve, para uso diário	200 000 tokens	Não
tai-4.0.6B	Equilibrado: o meio-termo entre velocidade e qualidade	200 000 tokens	Não
tai-4.0.7	Potente, para tarefas complexas e análise mais profunda	200 000 tokens	Não
tai-4.1	Raciocínio e criatividade de topo	200 000 tokens	Sim
tai-4.2	Geração mais recente, raciocínio mais forte e respostas mais rápidas	200 000 tokens	Sim

Todos os modelos partilham a mesma janela de contexto de 200 000 tokens, pelo que escolher entre eles é puramente uma questão de capacidade e custo, não de quanto histórico de conversa cabe. tai-4.1 e tai-4.2 são os dois níveis que aceitam entrada de imagem junto com texto, abordados em mais detalhe na página Imagens; os outros três são apenas de texto. Os preços por modelo estão na página Preços.

Escolher um modelo

Não há aqui uma única resposta certa, mas eis uma predefinição razoável: comece com tai-4.0.6P para qualquer caso sensível à latência ou de alto volume, onde "suficientemente bom, rápido e barato" vence "o mais capaz possível". Avance para tai-4.0.7 ou tai-4.1 quando uma tarefa realmente precisar de raciocínio mais profundo, trabalho mais longo em vários passos, ou compreensão de imagens, e o custo e a latência extra valerem a pena para esse pedido específico. O tai-4.2 é o nível mais recente e, em geral, o melhor equilíbrio global entre as duas opções multimodais; recorra especificamente ao tai-4.1 quando uma tarefa beneficiar mais de profundidade máxima de raciocínio do que de velocidade pura.

Nada o impede de escolher o modelo por pedido, em vez de se comprometer com um único modelo para toda uma aplicação. Um padrão comum é usar um modelo rápido para turnos de rotina e um mais capaz invocado apenas quando um pedido é sinalizado (pelo comprimento, por palavra-chave, pela própria avaliação de um modelo anterior) como precisando de mais profundidade.

Um modelo não reconhecido

Enviar um valor de model que não seja um dos cinco acima é rejeitado antes de qualquer geração começar, com um 400:

{"error": {"message": "Unknown model: 'tai-4.9'. See https://docs.artfical.com/tai/en for the current list.", "type": "invalid_request_error"}}

Isto inclui um ID de modelo com erro de escrita, um ID antigo que foi retirado, ou um nome de modelo de um fornecedor completamente diferente (um pedido que, por acidente, ainda aponta para uma string de modelo como "gpt-4" de uma integração anterior, por exemplo, já que é o URL base que encaminha o pedido para a tAI, mas o próprio ID de modelo ainda tem de ser um dos nossos). Consulte Erros para o formato completo do erro.