Documentação da API compatível com OpenAI |IteraCompute

Primeira chamada gratuita

Registre-se e verifique seu e-mail ou faça login no Google.Não é necessário cartão ou recarga.
Abra as chaves de API, crie uma chave que permita qwen/qwen3.8-27b e salve o segredo mostrado uma vez.
Execute isso no Bash (macOS, Linux ou WSL) com cURL e Python 3. Substitua your-api-key pela sua chave.Mantenha o response.json local.

Bash · Qwen3.8-27B · $0

exportar ITERACOMPUTE_API_KEY="sua chave de API"

curl --fail-with-body --max-time 180 https://api.iteracompute.com/v1/chat/completions \-H "Autorização: Portador $ITERACOMPUTE_API_KEY" \-H "Tipo de conteúdo: aplicativo/json" \-d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Responda exatamente com: Olá!"}],"max_tokens":512,"chat_template_kwargs":{"enable_thinking":false}}' \ -o resposta.json && python3 -c 'importar json;r=json.load(open("response.json"));text=r["choices"][0]["message"]["content"];assert text e text.strip(), "Resposta do modelo vazio: a ativação está incompleta";imprimir(texto)'

Sucesso significa escolhas não vazias[0].message.content.Este comando imprime e falha em uma resposta vazia;o registro ou o HTTP 200 por si só não completam a ativação.Resultado esperado: Olá!(o texto pode variar).

Este exemplo Qwen desativa o pensamento para uma resposta curta e visível.401/403: verifique a chave e a permissão do modelo.429: verifique o uso mensal e o TPM no Console e, em seguida, repita Retry-After.A capacidade livre pode ficar em fila;não dispare repetidas tentativas paralelas.

Guia de início rápido da API → · Subsídio e limites gratuitos →

Suporte e custos do modelo

Os exemplos avançados abaixo usam Flash DeepSeek V4.1 pago e deduzem o uso do seu saldo de API.Verifique os preços atuais de entrada, entrada em cache e saída na página Modelos.Qwen3.8-27B gratuito suporta conclusões de bate-papo, streaming e chamadas de ferramentas;este guia não estabelece suporte à API Qwen Responses.IDs de modelo e parâmetros de raciocínio não são intercambiáveis.Confirme se o modelo selecionado suporta cada endpoint e opção antes de adaptar um exemplo.

Preços do DeepSeek V4.1 Flash →

1. Visão geral

A API IteraCompute é compatível com OpenAI: se sua aplicação já se comunica com a API OpenAI, a migração é uma mudança de URL_base e chave API.Conclusões de bate-papo, respostas, streaming e chamadas de ferramentas seguem formatos compatíveis onde o modelo selecionado os suporta.

2. URL base e autenticação

As solicitações de API vão para https://api.iteracompute.com/v1.As solicitações de conclusões e respostas de bate-papo são autenticadas com sua chave de API no Autorização cabeçalho.

exportar ITERACOMPUTE_API_KEY="sua chave de API"

curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \ -H "Autorização: Portador $ITERACOMPUTE_API_KEY" \-H "Tipo de conteúdo: aplicativo/json" \-d '{"model":"deepseek/deepseek-v4.1-flash","messages":[{"role":"user","content":"Responder exatamente com: Olá!"}],"temperature":0,"max_tokens":128}'

3. IDs do modelo

Use o exato provedor/modelo ID retornado pelo endpoint Models;não adicione um iteracomputar/ prefixo.Liste os modelos atualmente publicados pelo gateway:

curl --fail-with-body https://api.iteracompute.com/v1/models

O endpoint Models é público e retorna o catálogo de gateway atual.Use seu identificação valores exatamente como retornados.O acesso comercial a um modelo ainda é controlado pela sua chave de API e contrato.

4. Conclusões de bate-papo

POST /v1/chat/completions segue o formato de solicitação e resposta OpenAI:

importar sistema operacional
de openai importar Cliente OpenAI = OpenAI( base_url="https://api.iteracompute.com/v1", api_key=os.environ["ITERACOMPUTE_API_KEY"], ) resp = client.chat.completions.create(model="deepseek/deepseek-v4.1-flash", mensagens=[{"papel": "usuário", "conteúdo": "Responda exatamente: Olá!"}], temperatura=0, max_tokens=128, )

imprimir(resp.choices[0].message.content)
imprimir(resp.uso)  # prompt_tokens/completion_tokens/total_tokens

5. API de respostas

POST /v1/respostas suporta a API OpenAI Responses usada por clientes como Codex:

importar sistema operacional
de openai importar Cliente OpenAI = OpenAI( base_url="https://api.iteracompute.com/v1", api_key=os.environ["ITERACOMPUTE_API_KEY"], ) resposta = client.responses.create(model="deepseek/deepseek-v4.1-flash", entrada ="Responda exatamente: Olá!", max_output_tokens=128, )
imprimir(resposta.output_text)

6. Transmissão (SSE)

Definir "fluxo": verdadeiro para receber eventos enviados pelo servidor.Os pedaços chegam conforme gerados;o uso do token está incluído no pedaço final que carrega uso, antes do terminal [CONCLUÍDO] evento.Trate o fluxo como uma solicitação lógica: depois que os tokens forem emitidos, a solicitação não será repetida de forma transparente.

importar sistema operacional
de openai importar Cliente OpenAI = OpenAI( base_url="https://api.iteracompute.com/v1", api_key=os.environ["ITERACOMPUTE_API_KEY"], ) stream = client.chat.completions.create(model="deepseek/deepseek-v4.1-flash", mensagens=[{"papel": "usuário", "conteúdo": "Responda exatamente: Olá!"}], fluxo=Verdadeiro, stream_options={"incluir_usage": Verdadeiro}, temperatura=0, max_tokens=128, )

para pedaço em fluxo:
    se pedaço.escolhas e pedaço.choices[0].delta.content:
        imprimir(chunk.choices[0].delta.content, end="")
    se pedaço.uso:  # parte final: uso de token
        imprimir("\n", pedaço.uso)

7. Chamada de ferramenta

As ferramentas são declaradas no ferramentas parâmetro, seguindo o formato de chamada de função OpenAI.Quando o modelo decide chamar uma ferramenta, a resposta contém chamadas_ferramentas;enviar os resultados da ferramenta de volta com a função "ferramenta" para continuar a conversa.

importar json
importar sistema operacional
de openai importar Cliente OpenAI = OpenAI( base_url="https://api.iteracompute.com/v1", api_key=os.environ["ITERACOMPUTE_API_KEY"], ) mensagens = [{"papel": "usuário", "conteúdo": "Qual é o clima em Cingapura?"}] ferramentas = [{
    "tipo": "função",
    "função": {
        "nome": "get_weather",
        "descrição": "Obter o clima atual de uma cidade",
        "parâmetros": {
            "tipo": "objeto",
            "propriedades": {"cidade": {"tipo": "corda"}},
            "obrigatório": ["cidade"], }, }, }] resp = client.chat.completions.create(model="deepseek/deepseek-v4.1-flash", mensagens=mensagens, ferramentas=ferramentas, tool_choice={"tipo": "função", "função": {"nome": "get_weather"}}, max_tokens=512, ) assistant_message = resp.choices[0].message messages.append(assistant_message)

para ligar em assistant_message.tool_calls ou []: argumentos = json.loads(call.function.arguments) resultado = {"cidade": argumentos["cidade"], "temperatura_c": 29} mensagens.append({
        "papel": "ferramenta",
        "tool_call_id": ligar.id,
        "conteúdo": json.dumps (resultado), }) final = client.chat.completions.create(model="deepseek/deepseek-v4.1-flash", mensagens=mensagens, ferramentas=ferramentas, max_tokens=512, )
imprimir(final.escolhas[0].message.content)

8. Códigos de erro

Os erros usam o formato de erro OpenAI com um corpo JSON de {"erro": {"mensagem", "tipo", "código"}}:

Estado	Significado
400	Solicitação inválida – JSON malformado ou parâmetros obrigatórios ausentes
401	Falha na autenticação – chave de API ausente ou inválida
403	Chave não permitida para este modelo ou ação
404	Modelo ou endpoint desconhecido
429	Limite de taxa excedido - desacelere e respeite Retry-After
500	Erro interno – é seguro tentar novamente a solicitação
503	Modelo temporariamente indisponível. Tente novamente com espera

9. Limites de taxas

Qwen3.8-27B usa subsídios mensais para toda a conta e TPM.Free / Starter / Pro fornece 30 milhões / 100 milhões / 300 milhões de tokens por mês UTC, 160 mil / 300 mil / 600 mil TPM e contexto de 128 mil / 128 mil / 256 mil.A recarga líquida concluída de US$ 10 ou US$ 50 desbloqueia Starter ou Pro.As contas gratuitas podem entrar na fila quando a capacidade da GPU está ocupada, com até 32 solicitações em espera por GPU e 120 segundos de espera.Outros modelos usam seus limites principais.Retornam licenças esgotadas, filas cheias e timeouts 429;honra Tentar novamente depois antes de tentar novamente.

10. Suporte

Perguntas de integração: support@iteracompute.com