Lista de modelos

Obtenha uma lista de todos os modelos de IA acessíveis ao usuário atual, incluindo IDs, nomes, provedores e informações detalhadas.

Sobre a lista de modelos e grupos de tokens

Os modelos retornados na lista dependem do grupo de tokens ao qual sua API KEY pertence. Você pode selecionar o grupo de tokens ao criar ou editar tokens em Console → API Tokens.

Endpoint

GET https://aiberm.com/v1/models

Exemplo de solicitação

1curl -X GET "https://aiberm.com/v1/models" \
2-H "Authorization: Bearer sk-your-api-token-here" \
3-H "Content-Type: application/json"

Formato da resposta

Resposta de sucesso (200 OK)

1{
2"success": true,
3"data": [
4 {
5 "id": "gpt-4",
6 "object": "model",
7 "created": 1626777600,
8 "owned_by": "openai",
9 "supported_endpoint_types": [
10 "chat",
11 "completion"
12 ]
13 },
14 {
15 "id": "gpt-3.5-turbo",
16 "object": "model",
17 "created": 1626777600,
18 "owned_by": "openai",
19 "supported_endpoint_types": [
20 "chat",
21 "completion"
22 ]
23 },
24 {
25 "id": "claude-3-sonnet-20240229",
26 "object": "model",
27 "created": 1626777600,
28 "owned_by": "anthropic",
29 "supported_endpoint_types": [
30 "chat"
31 ]
32 }
33]
34}

Campos da resposta

Campos de nível superior:

  • success - Boolean, indica se a solicitação foi bem-sucedida
  • data - Array de objetos de modelo (retornado apenas em caso de sucesso)
  • message - Mensagem de erro (retornada apenas em caso de falha)

Campos do objeto de modelo:

  • id - Identificador exclusivo do modelo
  • object - Tipo do objeto, fixo como “model”
  • created - Timestamp de criação do modelo
  • owned_by - Provedor do modelo (por exemplo, openai, anthropic)
  • supported_endpoint_types - Array dos tipos de endpoint da API compatíveis

Tipos de endpoint compatíveis

  • chat - Conclusão de chat
  • completion - Conclusão de texto
  • embedding - Embedding de texto
  • image - Geração de imagens
  • audio - Processamento de áudio
  • rerank - Reclassificação

Observações importantes

Autenticação obrigatória

Um token de API válido deve ser fornecido. O token determina quais modelos o usuário pode acessar.

Controle de permissões

A lista de modelos retornada é filtrada com base nos grupos de usuários e nos grupos de tokens, mostrando apenas os modelos aos quais o usuário tem permissão de acesso.

Erros comuns

  • 401 Unauthorized - O token de API é inválido ou expirou
  • 403 Forbidden - O usuário não tem permissão de acesso
  • 500 Internal Server Error - Erro interno do servidor