|

3 formas de configurar la URL base de APIYI: /v1 para uso general, dominio raíz para Claude y /v1beta para Gemini

PorAPIYI - Stable and affordable AI API

title: "Guía definitiva: Configuración de Base URL y nodos en APIYI"
description: "Domina la configuración de Base URL y nodos en APIYI. Evita errores comunes y optimiza tus invocaciones de modelos con esta guía práctica."

Nota del autor: Explicación detallada sobre cómo configurar correctamente las 3 rutas de Base URL y los 3 nodos de dominio en la plataforma APIYI, para que los desarrolladores puedan realizar la configuración a la primera y evitar errores comunes.

Al configurar la API de un Modelo de Lenguaje Grande, escribir mal la Base URL es uno de los problemas más frecuentes para los desarrolladores. Los diferentes proveedores de modelos utilizan distintas especificaciones de ruta: OpenAI usa /v1, Anthropic Claude usa el dominio raíz y Google Gemini usa /v1beta. Si no conoces estas diferencias, la invocación del modelo fallará inevitablemente.

La plataforma APIYI es totalmente compatible con estas tres especificaciones de ruta y ofrece 3 nodos de dominio (principal nacional, respaldo nacional y exclusivo para el extranjero) para garantizar una conexión estable a nivel global. En este artículo, utilizaremos tablas claras y ejemplos de código para ayudarte a configurar todos los escenarios correctamente desde el primer intento.

Valor principal: Al terminar de leer este artículo, dominarás el método completo de configuración de la Base URL en APIYI y dejarás de perder tiempo de depuración por errores de ruta.

apiyi-base-url-v1-claude-gemini-endpoint-config-guide-es 图示

Puntos clave de la Base URL de APIYI

Punto clave Descripción Valor
3 especificaciones de ruta /v1 genérico, dominio raíz para Claude, /v1beta para Gemini Una plataforma compatible con todos los SDK principales
3 nodos de dominio Principal nacional, respaldo nacional, exclusivo internacional Baja latencia global + alta disponibilidad ante fallos
Formato compatible con OpenAI Usa la ruta /v1 para invocar GPT, DeepSeek, Llama, etc. Migración cambiando solo una línea de base_url
Conexión directa con SDK nativo Claude y Gemini pueden usar sus SDK oficiales sin conversiones Integración con coste de modificación cero

Detalle de las especificaciones de ruta de la Base URL de APIYI

Diferentes proveedores de IA han elegido distintos estilos de ruta al diseñar sus API. Esto no es arbitrario, sino un acuerdo estricto dentro de los SDK de cada fabricante:

Serie OpenAI (/v1): OpenAI utilizó el prefijo de versión /v1 en la URL desde el principio. Su SDK de Python concatena directamente la base_url que configures (que incluye /v1) con la ruta del recurso (como /chat/completions). Todos los modelos compatibles con OpenAI (serie GPT, DeepSeek, Llama, Qwen, MiniMax, etc.) siguen esta convención.

Serie Anthropic (dominio raíz): Anthropic eligió un enfoque diferente: el SDK concatena internamente la ruta /v1/messages, por lo que la base_url solo necesita el dominio raíz y no debe incluir /v1. Si añades /v1 por error, el SDK generará /v1/v1/messages, lo que provocará un error 404.

Serie Google Gemini (/v1beta): Google acostumbra a usar /v1beta para identificar API que aún no han alcanzado la disponibilidad general (GA). El formato de punto final de Gemini es /v1beta/models/{model}:generateContent, y el SDK también gestiona automáticamente la concatenación de la ruta.

Selección de nodos de dominio para la Base URL de APIYI

APIYI ofrece 3 nodos de dominio para cubrir diferentes entornos de red:

Nodo Dominio Escenario de uso Descripción
Principal nacional api.apiyi.com Servidores nacionales, desarrollo local Recomendado, latencia mínima
Respaldo nacional b.apiyi.com Cambio en caso de fallo del nodo principal Respaldo para garantizar la continuidad del negocio
Exclusivo internacional vip.apiyi.com Despliegue en servidores extranjeros Optimización de rutas internacionales, conexión directa de baja latencia

🎯 Sugerencia de selección: Los usuarios nacionales deben priorizar api.apiyi.com y configurar b.apiyi.com como fallback en su código. Los servicios desplegados en el extranjero deben usar directamente vip.apiyi.com. Todos los nodos ofrecen la misma funcionalidad, solo difieren en la ruta de red.

Configuración rápida de la Base URL de APIYI

Escenario 1: Invocar modelos compatibles con OpenAI (GPT / DeepSeek / Llama, etc.)

Regla de ruta: Dominio + /v1

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # Principal nacional + /v1
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "¡Hola!"}]
)
print(response.choices[0].message.content)

Escenario 2: Invocar modelos Claude (SDK de Anthropic)

Regla de ruta: Dominio (dominio raíz, sin añadir /v1)

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com"  # Dominio raíz, sin sufijo de ruta
)

message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "¡Hola!"}]
)
print(message.content[0].text)

Escenario 3: Invocar modelos Gemini (SDK de Google GenAI)

Regla de ruta: Dominio + /v1beta

from google import genai

client = genai.Client(
    api_key="YOUR_API_KEY",
    http_options={"api_version": "v1beta", "base_url": "https://api.apiyi.com"}
)

response = client.models.generate_content(
    model="gemini-2.5-pro",
    contents="¡Hola!"
)
print(response.text)

Sugerencia: Obtén saldo de prueba gratuito a través de APIYI (apiyi.com). Puedes configurar y verificar los tres escenarios anteriores en menos de 5 minutos.

apiyi-base-url-v1-claude-gemini-endpoint-config-guide-es 图示

Tabla de referencia rápida: Configuración completa de la Base URL de APIYI

Aquí tienes todas las combinaciones de dominio × ruta. Solo tienes que copiar y pegar para empezar a usarlo:

Configuración de la Base URL de APIYI: Modelos compatibles con OpenAI

Nodo de dominio Base URL Modelos aplicables SDK aplicable
Principal nacional https://api.apiyi.com/v1 GPT, DeepSeek, Llama, Qwen, MiniMax, etc. OpenAI Python/Node SDK
Respaldo nacional https://b.apiyi.com/v1 Igual que el anterior Igual que el anterior
Exclusivo internacional https://vip.apiyi.com/v1 Igual que el anterior Igual que el anterior

Configuración de la Base URL de APIYI: Modelos Claude

Nodo de dominio Base URL Modelos aplicables SDK aplicable
Principal nacional https://api.apiyi.com Claude Opus 4.6, Sonnet 4.6, Haiku, etc. Anthropic Python/TS SDK
Respaldo nacional https://b.apiyi.com Igual que el anterior Igual que el anterior
Exclusivo internacional https://vip.apiyi.com Igual que el anterior Igual que el anterior

Configuración de la Base URL de APIYI: Modelos Gemini

Nodo de dominio Base URL Modelos aplicables SDK aplicable
Principal nacional https://api.apiyi.com/v1beta Gemini 2.5 Pro, 2.5 Flash, etc. Google GenAI SDK
Respaldo nacional https://b.apiyi.com/v1beta Igual que el anterior Igual que el anterior
Exclusivo internacional https://vip.apiyi.com/v1beta Igual que el anterior Igual que el anterior

🎯 Sugerencia de configuración: Las diferencias en estas tres rutas vienen determinadas por la implementación interna de los SDK de cada proveedor, no son un requisito especial de APIYI. Recuerda esta regla mnemotécnica: OpenAI lleva /v1, Claude no lleva nada, y Gemini lleva /v1beta; así nunca te equivocarás.

Errores comunes y solución de problemas en la Base URL de APIYI

apiyi-base-url-v1-claude-gemini-endpoint-config-guide-es 图示

Guía rápida de solución de errores:

Fenómeno de error Causa probable Solución
404 Not Found Falta /v1 en el SDK de OpenAI, o se añadió de más en el de Anthropic Verifica que la ruta coincida con la especificación del SDK
400 Bad Request Versión de ruta de Gemini incorrecta Confirma el uso de /v1beta
Connection Timeout Nodo de dominio mal seleccionado Usa api.apiyi.com para nacional, vip.apiyi.com para internacional
SSL Error Falta el prefijo https:// Todos los nodos deben usar HTTPS
Error de doble barra // Sobra una / al final de la base_url Elimina la barra final

Preguntas frecuentes

Q1: ¿Qué Base URL debo poner al invocar un modelo Claude con el SDK de OpenAI?

Si utilizas el SDK de OpenAI para invocar a Claude (a través de la interfaz compatible con OpenAI de APIYI), la Base URL debe ser https://api.apiyi.com/v1, igual que al invocar a GPT. Solo necesitas usar el dominio raíz si utilizas el SDK oficial de Anthropic. La diferencia clave radica en qué SDK estás utilizando, no en qué modelo estás invocando.

Q2: ¿Hay alguna diferencia en las funciones de los tres nodos de dominio?

Las funciones son exactamente iguales; la única diferencia es la optimización de la red. api.apiyi.com tiene la latencia más baja en China, vip.apiyi.com tiene la latencia más baja en el extranjero, y b.apiyi.com es un nodo de respaldo para recuperación ante desastres en China. Se recomienda configurar un mecanismo de fallback en tu código para cambiar automáticamente al nodo de respaldo si el nodo principal agota el tiempo de espera.

Q3: ¿Cómo verificar rápidamente si la configuración de la Base URL es correcta?

Recomendamos utilizar la plataforma APIYI para la verificación:

  1. Visita apiyi.com, registra una cuenta y obtén tu clave API.
  2. Utiliza el ejemplo de código de este artículo, reemplaza YOUR_API_KEY y ejecútalo.
  3. Si recibes una respuesta normal, la configuración es correcta; si recibes un error 404 o 400, verifica si la ruta coincide con las especificaciones del SDK.

Resumen

Puntos clave para la configuración de la Base URL en APIYI:

  1. Reglas de ruta: El SDK de OpenAI usa /v1, el SDK de Anthropic usa el dominio raíz (sin sufijo de ruta) y el SDK de Google GenAI usa /v1beta.
  2. Selección de dominio: Prioriza api.apiyi.com para China, usa vip.apiyi.com para el extranjero y b.apiyi.com como respaldo.
  3. Consejos para evitar errores: No añadas /v1 al SDK de Anthropic, no olvides el /v1 en el SDK de OpenAI y no incluyas una barra diagonal al final.

Recuerda la regla de oro: OpenAI lleva /v1, Claude no lleva, y Gemini lleva /v1beta; así no te equivocarás en la configuración.

Te recomendamos obtener saldo gratuito en apiyi.com para realizar pruebas rápidas. La plataforma es compatible de forma unificada con las tres especificaciones de ruta y admite la invocación del modelo para todos los modelos principales.

📚 Referencias

  1. Documentación de la API de OpenAI: Instrucciones para la integración de la API y uso del SDK

    • Enlace: platform.openai.com/docs/api-reference
    • Descripción: Referencia oficial de la API de OpenAI para comprender la especificación de la ruta /v1

  2. Documentación de la API de Anthropic: Guía de integración para modelos Claude

    • Enlace: docs.anthropic.com/en/api/getting-started
    • Descripción: Comprender la especificación base_url del SDK de Anthropic

  3. Google AI for Developers: Instrucciones de integración de la API de Gemini

    • Enlace: ai.google.dev/gemini-api/docs
    • Descripción: Comprender la ruta /v1beta y la configuración del SDK de GenAI

  4. Documentación de la plataforma APIYI: Guía de integración y configuración rápida

    • Enlace: docs.apiyi.com
    • Descripción: Obtención de la clave API, lista de modelos y configuración de nodos múltiples

Autor: Equipo técnico de APIYI
Intercambio técnico: Te invitamos a participar en la sección de comentarios. Para más información, visita el centro de documentación de APIYI en docs.apiyi.com

Try AI Large Model https://api.apiyi.com for free
Stable and reliable AI LM API aggregation service, Get 300 Millions Tokens for Free~

Publicaciones Similares