Integración con el SDK de OpenAI (Python / Node)

Documentación mantenida por 1ZheAI. Fuentes y correcciones.

¿Encontraste un error? Contacta con soporte indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

Si ya tienes código escrito con el SDK de OpenAI, cambiar a 1折AI solo requiere modificar dos parámetros: base_url y api_key. Introduce el ID del modelo GPT o Claude disponible actualmente.

Instalación

Python

Python

pip install openai

Node.js

Node.js

npm install openai

Llamada

Python

Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://1zheai.com/v1",
    api_key=os.environ["ONEZHE_API_KEY"],
)

resp = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "用一句话解释什么是 prompt caching"}],
)
print(resp.model)
print(resp.choices[0].message.content)
print(resp.usage)

Node.js

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://1zheai.com/v1",
  apiKey: process.env.ONEZHE_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [{ role: "user", content: "用一句话解释什么是 prompt caching" }],
});
console.log(resp.model);
console.log(resp.choices[0].message.content);
console.log(resp.usage);

base_url debe incluir /v1.

Salida en streaming

Python

Python

stream = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "写一首四行的诗"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Node.js

Node.js

const stream = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [{ role: "user", content: "写一首四行的诗" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Usar variables de entorno sin modificar el código

El SDK oficial de OpenAI (Python y Node) lee OPENAI_BASE_URL y OPENAI_API_KEY. Cuando el código no pasa parámetros, basta con definir estas dos variables para cambiar de proveedor:

bash

export OPENAI_BASE_URL="https://1zheai.com/v1"
export OPENAI_API_KEY="sk-你的Key"

Ten en cuenta que esto afecta a todos los programas del mismo entorno que usen el SDK de OpenAI.

Cuándo cambiar al SDK de Anthropic

La API compatible con OpenAI es adecuada para “código existente que solo quiere cambiar de modelo”. Si necesitas el cache_control de Prompt Caching, extended thinking o el formato de llamada de herramientas de Claude, es más apropiado usar el SDK de Anthropic con la API nativa.

Preguntas frecuentes

404？

A base_url le falta /v1. El SDK de OpenAI solo añadirá /chat/completions al final.

¿Se pueden llamar modelos GPT?

Sí. Los modelos OpenAI / GPT ya están disponibles; usa el ID de modelo de los modelos admitidos que tu clave pueda invocar.

Responses y programa completo

Si necesitas el protocolo Responses, consulta la API de Responses. Si es tu primera vez usando Python o Node.js, puedes ejecutar directamente el ejemplo completo; antes de entrar en producción, configura timeouts y reintentos limitados.