Saltar para o conteúdo principal

Documentação da API

API Ilimitada

Aceda a modelos de IA suportados através de uma subscrição de fornecedor, com cobertura, preços e condições técnicas num só lugar.

Autenticação e permissões

Envie a chave de API de cliente no cabeçalho Authorization: Bearer através de HTTPS. Não inclua chaves nos URLs. A inferência Unlimited exige o âmbito ai:inference; as rotas de orçamentos, tarefas, estados e artefactos de treino exigem ai:training. Aplicam-se limites de pedidos. Uma chave de referência de treino também fica limitada ao modelo de referência que lhe foi concedido.

Gerir chaves de API no painel

  • POST /api/v1/chat/completions Authorization: Bearer ai:inference

Consultar a documentação

Conclusões de chat

Este ponto de acesso compatível com OpenAI aceita um pedido POST em JSON e devolve uma conclusão de chat. O conteúdo das mensagens tem de ser texto; as funções aceites são system, user e assistant.

O identificador do modelo e as mensagens são encaminhados para o gateway de IA predefinido actualmente configurado. Isto não garante encaminhamento directo para um fornecedor específico nem exige um SDK fixo.

POST https://fusionpointai.com/api/v1/chat/completions · ai:inference

Utilize o identificador exacto do modelo do fornecedor apresentado no catálogo da API Ilimitada. Os identificadores e a disponibilidade provêm do catálogo e podem mudar; o identificador do exemplo é apenas ilustrativo, não é um ID de modelo funcional.

Corpo do pedido

Pedido meramente ilustrativo. Substitua todos os valores entre sinais angulares pelos seus dados. Os IDs numéricos de referência, plano e factura são marcadores, não registos existentes.

{
    "model": "<MODEL_ID_FROM_UNLIMITED_CATALOGUE>",
    "messages": [
        {
            "role": "user",
            "content": "<YOUR_PROMPT>"
        }
    ],
    "temperature": 0.2,
    "max_tokens": 512
}

Resposta e erros

Uma resposta bem-sucedida inclui id, object, created, model e os campos choices e usage do fornecedor. Corpos inválidos devolvem HTTP 400 com error.message, error.type, error.code e detalhes dos campos. Falhas do fornecedor devolvem HTTP 500 com provider_error. Também podem ocorrer falhas de autenticação, permissões e limite de pedidos.

Erros comuns

  • 400 invalid_request_error Falta um campo obrigatório ou um valor não respeita o formato ou intervalo aceite.
  • 401 A chave bearer está ausente, é inválida, foi revogada ou está restringida.
  • 403 A chave não tem ai:inference ou uma chave de referência de treino está a ser usada para outro modelo.
  • 429 Foi atingido o limite de pedidos; aguarde antes de tentar novamente.
  • 500 provider_error O fornecedor de inferência não devolveu uma conclusão.

Acesso comercial, não treino de modelos

Uma subscrição dá acesso aos modelos incluídos no plano do fornecedor. O envio de um pedido de inferência não treina nem transfere pesos de modelos. Os valores mensais e anuais são os indicados nos registos comerciais activos.

Integração por API e SDK

Utilize o ponto de acesso à inferência documentado da FusionPointAI com uma chave de API de cliente e um identificador de modelo disponível. Um SDK formata e envia pedidos; não é necessariamente o local onde o modelo do fornecedor é executado. Consulte a referência da API para conhecer os formatos de pedido e a autenticação implementados.

Mantêm-se os limites técnicos

O acesso comercial ilimitado não elimina os limites da janela de contexto, de saída ou das modalidades específicas de cada modelo, os controlos de protecção do serviço nem as políticas aplicáveis do fornecedor. Antes de planear uma carga de trabalho, consulte o modelo escolhido e os termos do serviço.

Disponibilidade e acesso legado

Os planos exclusivos para clientes existentes continuam restritos. Um modelo pode estar disponível para inferência sem estar aprovado como referência de treino. Restrições operacionais temporárias não conferem direito a outro modelo do fornecedor.

Controlos de segurança e operação

Utilize chaves de API com permissões limitadas, mantenha os segredos no servidor e siga os controlos documentados para contas, rotação de chaves e acessos. Antes da utilização em produção, acorde quaisquer requisitos específicos da carga de trabalho relativos ao tratamento de dados ou ao suporte.

Da subscrição à integração

Compare os planos elegíveis, consulte os termos aplicáveis, subscreva através do processo de conta existente, obtenha as credenciais da API e valide os pedidos com a documentação da API.

Casos de utilização empresarial

Os modelos suportados podem ajudar na análise documental, assistência multilingue, fluxos de trabalho de software e extracção estruturada de informação. Escolha um modelo com base nas capacidades documentadas, sem presumir que todos aceitam os mesmos dados de entrada.

FAQ

A API Ilimitada treina um modelo para mim?

Não. Dá acesso de inferência a modelos suportados. Escolha o Treino de Modelos se precisar de um modelo de cliente treinado à parte.

Os modelos dos fornecedores são desenvolvidos pela FusionPointAI?

Não. O criador original continua identificado na página do serviço do fornecedor. A FusionPointAI fornece a integração da plataforma, o acesso comercial, a gestão de contas, a facturação, a documentação e o suporte.

Posso utilizar qualquer modelo listado como referência de treino?

Não. As permissões de treino, os recursos educativos aprovados e a compatibilidade de execução são verificados separadamente para cada configuração elegível.