AI

Usa a API de AI nas tuas aplicações e automatizações com uma chave API própria, entradas de texto e imagem, transmissão e respostas estruturadas.

Ligação: AI

Iniciar sessão/Registar

1. Abre Iniciar sessão.
2. Entra com Apple, Google ou um código por email. Os novos utilizadores são registados automaticamente.
3. A mesma conta gere os teus serviços AI, saldo e documentos de faturação.

Carregar saldo

1. Abre Métodos de pagamento e adiciona fundos com um método disponível.
2. Mantém saldo suficiente para o preço mensal apresentado antes da compra e para futuras renovações.

Comprar o serviço

1. Abre AI.
2. Introduz um nome para a tua aplicação ou integração e prime Continuar.
3. Confirma o preço mensal e a criação do serviço. Abre a encomenda AI no Perfil para veres a chave API e o limite de pedidos por minuto.

Ligar a aplicação

Define AI_API_KEY de forma segura com a chave gerada. Guarda-a no servidor; não a incluas no código público do site nem nos pacotes da aplicação móvel.

Em clientes com um URL base de API configurável, usa https://yoosolutions.com/api/v1/ai e o modelo ai. O fornecedor e o modelo atribuídos à tua encomenda processam o pedido; as funcionalidades disponíveis dependem desse modelo.

curl --request POST 'https://yoosolutions.com/api/v1/ai/chat/completions' \
  --header "Authorization: Bearer ${AI_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model":"ai","messages":[{"role":"user","content":"Resume o progresso deste projeto."}]}'

Lê a resposta em choices[0].message.content no resultado JSON.

Pedidos suportados

• Envia texto em messages. As mensagens do utilizador também podem incluir partes image_url com dados JPEG, PNG ou WebP em base64; os URL de imagens remotas são rejeitados.
• Usa response_format com text, json_object ou json_schema. A resposta com esquema JSON exige strict: true.
• Define stream: true para transmissão. Para incluir os dados de utilização, define também stream_options.include_usage: true.
• Controla o tamanho da resposta com max_completion_tokens. Se for enviado, store tem de ser false; os restantes campos de pedido não documentados são rejeitados.
• Os pedidos não guardam o estado da conversa. Inclui em messages o histórico necessário para cada pedido.

Limites e faturação

• Os pedidos estão limitados a 20 MiB, 120 segundos e 16384 tokens de saída, com 4096 tokens de saída por predefinição.
• O limite de pedidos por minuto apresentado na encomenda usa uma janela móvel de 60 segundos e mantém-se quando a chave é reposta.
• As renovações são cobradas ao saldo. Se uma renovação ficar por pagar, o acesso à API é bloqueado até ao pagamento bem-sucedido. O histórico de faturação, as faturas e os recibos estão disponíveis no Perfil.

Gerir o serviço

• Editar altera o nome do serviço sem modificar a chave, o modelo ou o limite.
• Repor gera uma nova chave API e revoga imediatamente a anterior. Atualiza a chave na aplicação; a reposição não reinicia o limite de pedidos.
• Remover revoga o acesso à API e interrompe as futuras cobranças do serviço.

Resolução de problemas

• 400: verifica os campos do pedido, o modelo ai e o formato das mensagens.
• 401: verifica a chave bearer e atualiza-a após a reposição.
• 402: verifica o saldo e o pagamento da renovação no Perfil.
• 429: antes de tentares novamente, aguarda o número de segundos indicado no cabeçalho Retry-After.
• 503: o modelo ou fornecedor atribuído está indisponível. Tenta novamente mais tarde ou contacta o Suporte.