PT ▾

Chinese LLM APITradução

Obter chave de API

Atualizado

URL da API compatível com OpenAI: URL base e cabeçalhos

A URL base é https://api.chinesellmapi.com/v1. Coloque-a onde seu cliente OpenAI espera uma URL base, adicione sua chave como token Bearer e use o ID do modelo uncensored.

Um cabo ligando o terminal de um laptop a um cubo de servidor brilhante, representando a conexão de um cliente a um endpoint de API

A resposta curta

Se você está procurando uma URL de API compatível com openai para este serviço, copie este valor:

https://api.chinesellmapi.com/v1

Esta é a URL base. Cada SDK OpenAI, cliente desktop e framework de agente que possui um campo chamado "base URL", "API base", "endpoint" ou "host" aceita esta string. A chave vai no campo "API key" correspondente, e o nome do modelo é uncensored.

Existem dois endpoints por trás disso: POST /v1/chat/completions para chat e GET /v1/models para listar modelos. Nada mais da interface OpenAI é oferecido, então não há rota de embeddings, nem de imagens, nem de fine-tuning. Se você precisa de uma chave primeiro, a página da chave de API guia você pelo processo de cadastro.

URL base versus URL de endpoint completo

A maioria dos erros acontece aqui. Os clientes se dividem em dois grupos: aqueles que querem a URL base e adicionam o caminho eles mesmos, e aqueles que querem a URL completa da chamada. A tabela mostra ambas as formas.

O que o campo solicitaValor a inserir
URL base, API base, host OpenAIhttps://api.chinesellmapi.com/v1
URL completa de chat completionshttps://api.chinesellmapi.com/v1/chat/completions
URL da lista de modeloshttps://api.chinesellmapi.com/v1/models

Os SDKs oficiais da OpenAI, o wrapper OpenAI do LangChain, LiteLLM e a maioria das interfaces de chat pertencem ao primeiro grupo. Ferramentas que permitem colar uma URL de requisição bruta pertencem ao segundo. Quando o rótulo do campo não diz qual é, leia o texto do placeholder: se mostrar algo terminando em /v1, ele quer a URL base.

Barras finais

A maioria dos SDKs lida com barra final, mas alguns constroem o caminho final por concatenação simples de strings. Se você receber 404 e a URL terminar com /v1/, remova a última barra e tente novamente.

Cabeçalhos que a API espera

As requisições precisam de um cabeçalho para autenticação e outro para o tipo de corpo:

  • Authorization: Bearer YOUR_KEY
  • Content-Type: application/json

Os SDKs definem ambos para você. Se você construir requisições manualmente, aqui está a chamada mínima funcional:

curl https://api.chinesellmapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in one sentence."}]
  }'

A resposta carrega alguns cabeçalhos dignos de log: X-Request-Id para perguntas de suporte, X-Balance-USD para o crédito restante, e X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency para os limites aplicáveis à sua chave.

Configurando nos SDKs OpenAI

Apenas dois valores mudam em comparação com uma configuração OpenAI padrão: a URL base e a chave. Tudo o resto no seu código permanece como está.

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.chinesellmapi.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Translate 'good morning' into Chinese."}],
)
print(resp.choices[0].message.content)

Node

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Translate 'good morning' into Chinese." }],
});
console.log(resp.choices[0].message.content);

O streaming funciona da mesma forma: adicione stream: true e leia os fragmentos. As figuras de uso chegam no final do stream. Lembre-se de que uma requisição streaming ocupa um dos seus slots de concorrência até que o stream seja encerrado.

Variáveis de ambiente em vez de código

Os SDKs OpenAI atuais para Python e Node leem OPENAI_BASE_URL e OPENAI_API_KEY do ambiente quando você não os passa no código. Essa é a maneira mais rápida de apontar um projeto existente para um novo endpoint sem tocar em uma linha:

export OPENAI_BASE_URL="https://api.chinesellmapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py

Muitas ferramentas de terceiros usam os mesmos dois nomes de variável, embora algumas usem os seus próprios, como API_BASE ou OPENAI_API_BASE em projetos mais antigos. Consulte a documentação da ferramenta para saber o nome exato. Se um projeto codificar api.openai.com em algum lugar, pesquise a origem para esse nome de host e substitua-o.

O nome do modelo geralmente fica em uma configuração separada, então lembre-se de alterá-lo para uncensored também. Deixar um nome de modelo OpenAI padrão no lugar é a segunda causa mais comum de erro após uma URL incorreta.

Verifique a conexão antes de depurar seu aplicativo

Teste a URL e a chave com uma chamada que não custa nada. Listar modelos não precisa de tokens:

curl https://api.chinesellmapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

Se isso retornar uma lista JSON que inclui uncensored, a URL e a chave estão corretas e qualquer problema restante está nas configurações do seu cliente. Se falhar, use esta tabela.

SintomaCausa provávelCorreção
404 Not FoundCaminho duplicado (/v1/v1/...) ou /v1 ausenteInsira a URL base exatamente uma vez, terminando em /v1
401 Não AutorizadoChave ausente, copiada com um espaço ou enviada no cabeçalho erradoEnvie Authorization: Bearer YOUR_KEY e copie novamente a chave
429 com código rate_limitedMuitas requisições por minutoDiminua a velocidade ou faça fila nas requisições
429 com código concurrencyMuitas requisições ao mesmo tempoLimite chamadas paralelas, lembre-se que streams ocupam um slot
429 com Retry-After: 5Sobrecarga temporáriaAguarde cinco segundos e tente novamente
Modelo não encontradoUm nome de modelo OpenAI restanteDefina o modelo para uncensored

Limites que você deve conhecer antes de apontar a produção para isso

Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. A chave de teste permite 2 requisições simultâneas e 60 por minuto. O corpo da requisição pode ter até 8 MB, e a janela de contexto é de 100.000 tokens, prompt e conclusão juntos, então max_tokens é opcional.

O serviço é apenas de texto e executa um único modelo de pesos abertos de um fornecedor independente. Não é a API oficial de nenhum fornecedor de modelos e não faz roteamento entre fornecedores. Se o seu aplicativo é um produto em chinês, o guia rápido de aplicativo em chinês mostra como estruturar prompts, e o guia da API de tradução cobre glossários e espaços reservados.

A cobrança é pagamento por uso a partir de crédito pré-pago: $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Requisições falhas ou recusadas não são cobradas. A página de preços lista tamanhos de recarga e bônus, e novos usuários podem reivindicar $0,50 de crédito de teste com um clique na página da chave, válido por 7 dias e sem necessidade de cartão. Para um guia mais longo de configuração do cliente, consulte a documentação de início rápido.

Conteúdo que sexualiza menores de idade nunca é permitido; além disso, o modelo é ajustado para responder sem recusas de conteúdo para uso adulto legal.

Outros lugares onde a URL é usada

Os frameworks nomeiam o campo de formas diferentes, mas o valor é o mesmo. Três exemplos comuns:

# LangChain
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
    base_url="https://api.chinesellmapi.com/v1",
    api_key="YOUR_KEY",
    model="uncensored",
)

# LiteLLM
import litellm
r = litellm.completion(
    model="openai/uncensored",
    api_base="https://api.chinesellmapi.com/v1",
    api_key="YOUR_KEY",
    messages=[{"role": "user", "content": "ping"}],
)

No LiteLLM, o prefixo openai/ diz à biblioteca para usar o formato wire da OpenAI contra sua própria URL base, e a parte após a barra é o ID do modelo. Interfaces de chat como SillyTavern têm uma fonte "compatível com OpenAI personalizada" com três caixas: URL, chave e modelo. Os mesmos três valores novamente.

Mantenha a chave fora do navegador

Não chame a API a partir de JavaScript front-end entregue aos visitantes. Qualquer pessoa pode ler a chave da página e gastar seu crédito. Coloque uma pequena rota de servidor no meio, armazene a chave em uma variável de ambiente ali, e deixe seu site chamar essa rota.

Alternar entre endpoints sem alterações de código

Se você testar vários provedores, coloque os três valores em um arquivo de configuração em vez de no código. Um pequeno bloco de configurações faz o trabalho e torna a URL a única coisa que você edita:

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.getenv("LLM_BASE_URL", "https://api.chinesellmapi.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.getenv("LLM_MODEL", "uncensored")

Isso também facilita separar staging e produção: use uma chave diferente por ambiente, e o cabeçalho de resposta X-Balance-USD mostrará o crédito restante de cada um.

Perguntas e respostas

Devo incluir /chat/completions na URL base?

Não. Insira https://api.chinesellmapi.com/v1 e deixe o SDK adicionar /chat/completions. Apenas ferramentas que pedem uma URL de requisição completa precisam da forma mais longa.

Posso usar a mesma URL para vários aplicativos?

Sim. A URL e a chave podem ir para qualquer número de clientes. Elas compartilham os limites da sua chave: 8 requisições simultâneas e 300 requisições por minuto em uma chave completa.

Qual nome de modelo eu insiro?

Use uncensored. Você pode confirmar chamando GET /v1/models com sua chave.

Esta é a API oficial de um fornecedor estilo OpenAI?

Não. É uma API hospedada para um único modelo de pesos abertos executada por um provedor independente, construída para ser compatível com o formato de solicitação da OpenAI.

Como testar a chave sem gastar crédito?

Chame GET /v1/models com o cabeçalho Authorization. Ele retorna a lista de modelos e não usa tokens.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.

Obter chave de API