Inicio → Guías → Cherry Studio con una API personalizada: dirección, modelos, Claude e imágenes

Cherry Studio con una API personalizada: dirección, modelos, Claude e imágenes

Añadir un proveedor en Cherry Studio lleva menos de un minuto. El único campo que suele fallar es la dirección de la API, porque Cherry añade /v1 por su cuenta. Y en cuanto adjuntas capturas, importa qué modelos las ven de verdad: probamos siete.

Añadir el proveedor

Abre Ajustes → Proveedores de modelos y pulsa Añadir. Ponle un nombre (por ejemplo APICLAN) y elige el tipo OpenAI.
Pega tu clave API de la consola.
Escribe https://apiclan.us como dirección de la API.
Pulsa Comprobar y elige cualquier modelo para confirmar que la clave funciona.

Lo que escribes	Lo que llama Cherry Studio
`https://apiclan.us`	`https://apiclan.us/v1/chat/completions` ✓
`https://apiclan.us/v1/`	`https://apiclan.us/v1/chat/completions` ✓
`https://apiclan.us/v1`	`https://apiclan.us/v1/v1/chat/completions` ✗ 404

Cherry Studio añade /v1/chat/completions a la dirección salvo que termine en /. Así que https://apiclan.us y https://apiclan.us/v1/ funcionan, pero https://apiclan.us/v1 sin la barra final se convierte en /v1/v1 y devuelve 404.

Añadir modelos

Pulsa Gestionar bajo el proveedor. Cherry Studio obtiene la lista de /v1/models, que solo devuelve los modelos del grupo de tu clave. El 12 de octubre de 2026 era:

Grupo GPT: gpt-5.6-sol, gpt-5.6-terra, gpt-6-astra, gpt-6-sol, gpt-6.1-sol
Grupo DeepSeek: deepseek-v4-flash, deepseek-v4-pro, deepseek-v4.1-flash (más versiones con fecha)

Pulsa + junto a los que quieras. Si falta un modelo, tu clave pertenece a otro grupo: cada clave de esta pasarela está ligada a un único grupo.

Añadir Claude

Añade un segundo proveedor de tipo Anthropic, con la misma dirección https://apiclan.us y una clave creada en un grupo Claude. Después añade claude-opus-5-5 o claude-fable-5-1. Un proveedor por grupo evita mezclar claves: GPT, DeepSeek y Claude tienen cada uno su entrada.

Qué modelos leen las imágenes que adjuntas

Enviamos a cada modelo la misma imagen pequeña de un solo color, con la petición de estilo OpenAI que usa Cherry Studio, y le preguntamos de qué color era. Repetimos con un segundo color para que no valiera acertar por suerte.

Modelo	Lee imágenes	Tiempo de respuesta
`claude-opus-5-5`	✓	3.1 s
`claude-fable-5-1`	✓	3.3 s
`deepseek-v4.1-flash`	✓	2.3–3.1 s
`gpt-6-astra`	✓	6.6 s
`gpt-5.6-sol`	✓	7.3 s
`gpt-6.1-sol`	✓	24–25 s
`deepseek-v4-pro`	✗	—

deepseek-v4-pro no acepta imágenes: respondió «white» ante una imagen verde y la otra vez no devolvió nada, sin dar error. Para capturas, usa un modelo marcado. gpt-6.1-sol lee bien las imágenes pero tardó unos 24 segundos, frente a 2,6 segundos hasta el primer token en una petición solo de texto. Si Cherry Studio no muestra el botón de imagen en un modelo, abre sus ajustes y marca Visión. Prueba del 12 de octubre de 2026.

Errores comunes

401 → la clave es incorrecta o no corresponde al proveedor (por ejemplo, una clave GPT en el proveedor Anthropic).
404 → la dirección termina en /v1 sin barra. Usa https://apiclan.us.
model_not_found (is not supported by any configured account in this group) → el modelo no está en el grupo de tu clave. Añádelo desde Gestionar en vez de escribirlo.
La respuesta ignora tu imagen → el modelo no puede leer imágenes. Cambia a uno marcado en la tabla.

¿Configuras herramientas de programación? Cline con una API personalizada · Codex con una API personalizada.

Empieza a usarlo

Sin suscripción, sin mínimo mensual, sin llamada comercial. Recarga con USDT y gasta lo que uses — 1 USDT te da 2 créditos de saldo de API.

Lee el inicio rápido de 30 segundos

Idioma: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Los precios de esta página se rellenan automáticamente con datos de facturación reales. Las condiciones de terceros se citan de su propia documentación.