Compatível com OpenAI

Use o OpenAI SDK com uma API compatível com OpenAI

Construa com Python e JavaScript.

Conecte-se em três etapas

1. Crie uma chave API

Crie ou faça login em sua conta IteraCompute e, em seguida, crie uma chave no Console.

2. Configure o URL base

Defina base_url em Python ou baseURL em JavaScript e use as conclusões de bate-papo.

3. Selecione o modelo

Use o ID do modelo de API exato para o modelo escolhido.Verifique seu contexto e recursos antes de ativar recursos de agente ou visão.

Escolha seu modelo

Configuração de exemplo

Mantenha as chaves de API em seu ambiente de servidor ou armazenamento de credenciais de ferramentas.Substitua o campo-chave de exemplo pela sua própria chave, quando aplicável.

API compatível com OpenAI
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.iteracompute.com/v1",
    api_key=os.environ["ITERACOMPUTE_API_KEY"],
)
response = client.chat.completions.create(
    model="qwen/qwen3.8-27b",
    messages=[{"role": "user", "content": "Hello!"}],
    max_tokens=512,
    extra_body={"chat_template_kwargs": {"enable_thinking": False}},
)
text = response.choices[0].message.content
if not text or not text.strip():
    raise RuntimeError("Empty model reply: activation is incomplete.")
print(text)

Versão e verificação

Python SDK 2.14.0 · Python 3.11.4 · 15 de outubro de 2026: serialização de solicitação e manipulação de resposta não vazia/vazia verificada com um transporte simulado local.Isso não estabelece uma chamada de API real.A versão do JavaScript SDK e os resultados completos ainda não foram registrados.

Critério de sucesso

Execute os dois trechos do SDK.Cada um deve imprimir conteúdo não vazio;uma chave faltante ou uma resposta vazia deve parar o programa.

Grave a versão instalada
python -m pip show openai
npm ls openai

Teste a própria ferramenta configurada após a verificação da API abaixo.Um resultado HTTP 200 ou cURL por si só não verifica essa ferramenta.

Teste a conexão

cURL · Conclusões de bate-papo
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

Verifique se choices[0].message.content contém texto visível;O HTTP 200 por si só é insuficiente.O raciocínio pode consumir o orçamento de produção.Para Qwen grátis, use o exemplo da primeira chamada gratuita à API para desativar o pensamento e envie um prompt dentro de sua ferramenta.

Capacidades do modelo selecionado

Estes são recursos de API do modelo selecionado.A disponibilidade de recursos no seu fluxo de trabalho também depende da ferramenta e de suas configurações;os controles de raciocínio variam de acordo com o modelo.

  • Conclusões de bate-papoSuportado
  • Chamada de ferramentaSuportado
  • RaciocínioSuportado
  • Entrada de imagemSuportado
  • TransmissãoSuportado

Solução de problemas

URL base errado

Python usa base_url;JavaScript usa baseURL.Passe a chave IteraCompute explicitamente: a variável de ambiente padrão do SDK não é ITERACOMPUTE_API_KEY.

Ponto de extremidade errado

Chame client.chat.completions.create e leia choices[0].message.content.Exemplos de respostas e response.output_text usam uma API diferente.

HTTP 200, texto vazio

Um campo de conteúdo vazio não é um teste de texto bem-sucedido.Os exemplos gratuitos de Qwen permitem 512 tokens de saída e desabilitam o pensamento.Este parâmetro é específico do modelo.

429 / Limites de solicitação

Verifique o uso mensal e o TPM em toda a conta.Honre o Retry-After e evite novas tentativas paralelas.O Qwen grátis não tem excesso pago automaticamente;outros modelos usam seus preços publicados.

401/403: verifique a chave e a permissão do modelo.O Qwen grátis não requer saldo ou cartão.Para modelos pagos, verifique também o saldo disponível.

Referência de configuração do OpenAI SDK →

Comece a construir com OpenAI SDK.

Conecte sua chave, escolha um modelo e envie sua primeira solicitação.