Primeiros passos

Autenticação

Saiba como autenticar requisições na API do api14 com uma chave sk-api14 enviada como token Bearer, e como criar, proteger e revogar suas chaves.

Toda requisição a um endpoint tarifado é autenticada com uma chave de API do api14, enviada como token Bearer no cabeçalho Authorization.

Authorization: Bearer sk-api14-...

Os SDKs da OpenAI definem esse cabeçalho para você a partir da opção apiKey / api_key.

Chaves de API

Crie e gerencie chaves em Chaves de API.

As chaves começam com sk-api14- e são exibidas uma única vez, quando você as cria. Apenas um hash é armazenado, então uma chave perdida não pode ser recuperada, crie uma nova e revogue a antiga.
Cada chave pode ter seu próprio limite de requisições por minuto, limite diário de gasto em USD e lista de modelos permitidos. Veja Limites de taxa.
O número de chaves que você pode ter depende do seu plano: 1 no Free, 10 no Pro, mais no Team e no Enterprise.
Revogar uma chave tem efeito imediato; requisições com ela retornam 401 invalid_api_key.

Usando uma chave

Mantenha a chave em uma variável de ambiente e leia-a no código:

export API14_API_KEY="sk-api14-..."

curl https://api14.com/api/v1/chat/completions \
  -H "Authorization: Bearer $API14_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-5-mini", "messages": [{"role": "user", "content": "Hello"}]}'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.chat.completions.create({
  "model": "openai/gpt-5-mini",
  "messages": [
    {
      "role": "user",
      "content": "Explain vector databases in two sentences."
    }
  ]
});
console.log(result.choices[0].message.content);

Endpoints sem chave

Estes endpoints de catálogo somente leitura funcionam sem autenticação:

Endpoint	Descrição
`GET /models`	Todos os modelos disponíveis
`GET /models/{id}`	Um modelo
`GET /images/models`	Modelos de imagem com seus parâmetros extras
`GET /videos/models`	Modelos de vídeo com resoluções e durações
`GET /embeddings/models`	Modelos de embeddings

Todo o resto, endpoints de geração, /credits, /key, /generation e status de jobs de vídeo, exige uma chave.

Erros de autenticação

Uma chave ausente, malformada ou revogada retorna:

{
  "error": {
    "message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

com status HTTP 401. Uma chave restrita pela sua lista de permitidos retorna 403 model_not_allowed para outros modelos. Veja Erros.

Mantendo as chaves seguras

Nunca coloque uma chave em código de navegador ou de app mobile, qualquer pessoa pode lê-la ali. Chame o api14 a partir do seu servidor.
Nunca faça commit de chaves no controle de versão. Use variáveis de ambiente ou um gerenciador de segredos.
Use uma chave por app ou ambiente, para poder revogar uma sem quebrar as outras.
Defina um limite diário em USD nas chaves usadas por scripts ou serviços menos confiáveis, para que um bug não esgote seu saldo.
Se uma chave vazar, revogue-a imediatamente em Chaves de API.