Saltar para o conteúdo principal

Visão geral

Este endpoint cria uma nova API Key type=user na organização associada ao token de gerenciamento atual.

Corpo da requisição

CampoTipoPadrões / limitesDescrição
namestringobrigatório, padrão Default Key, tamanho 1-50Nome de exibição; o servidor remove espaços no início e no fim
limitAmountnumber | nullmínimo 0, máximo 100000null ou omitido = ilimitado, 0 = quota zero, valor positivo = teto de gasto em USD
limitCurrencyenumpadrão USDOpcional: USD ou CNY. Quando definido como CNY, limitAmount é interpretado em RMB e convertido para USD no servidor antes de ser armazenado
modelsstring[]padrão []Allowlist opcional de modelos lógicos
expiresAtstring | nulldatetime RFC3339null significa sem expiração

Observações

  • O valor completo da API Key aparece apenas uma vez na resposta.
  • models: [] significa que a chave não possui restrição adicional de modelos além da política da organização.
  • limitAmount: 0 cria uma chave válida, mas sem quota utilizável até que seja atualizada.
  • Por padrão, limitAmount é interpretado em USD. Se você enviar limitCurrency: "CNY", o limite será tratado como RMB e convertido automaticamente para USD com a taxa atual antes de ser armazenado.
  • A resposta inclui exchange_rate e os campos de exibição em RMB limit_amount_cny e used_amount_cny.

Exemplo

curl -X POST "https://api.lemondata.cc/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Worker",
    "limitAmount": 500,
    "models": ["veo3.1", "sora-2"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

Requisição / Resposta

Consulte o painel interativo de OpenAPI acima para ver o schema exato e os campos da resposta.