Интеграция Ace Data Cloud в Cherry Studio: единый API-токен для Claude, GPT и Gemini

Cherry Studio — популярный open-source десктопный AI-клиент для Windows, macOS и Linux. Его гибкость в настройке провайдеров позволяет подключить любой OpenAI-совместимый шлюз, включая Ace Data Cloud. В этой статье мы разберём, как настроить Cherry Studio для работы с несколькими семействами моделей через единую точку входа.

Зачем использовать Ace Data Cloud в Cherry Studio

Стандартная конфигурация Cherry Studio требует отдельной регистрации у каждого провайдера — OpenAI, Anthropic, Google. С Ace Data Cloud вы получаете единый API-токен для доступа к:

  • Claude (opus-4-8, sonnet-4-6, haiku-4-5)
  • GPT (gpt-5.6-sol, gpt-5.5, gpt-4o, o3)
  • Gemini (gemini-3.1-pro, gemini-2.5-pro)
  • Grok, Kimi, GLM, DeepSeek

Все запросы тарифицируются по фактическим токенам, история использования доступна в консоли Ace Data Cloud. Новые пользователи получают бесплатную квоту при первой регистрации.

Получение API-токена

Перейдите в консоль Ace Data Cloud и создайте приложение. Скопируйте API Token — он понадобится для настройки Cherry Studio.

Ключевая особенность: конкатенация пути API

Cherry Studio автоматически добавляет /v1/chat/completions к адресу API, если он не заканчивается символом #. Ace Data Cloud использует отдельные endpoints для каждого семейства моделей:

  • Claude: https://api.acedata.cloud (без #, т.к. путь по умолчанию совпадает)
  • GPT: https://api.acedata.cloud/openai/chat/completions#
  • Gemini: https://api.acedata.cloud/gemini/chat/completions#
  • Grok: https://api.acedata.cloud/grok/chat/completions#
  • DeepSeek: https://api.acedata.cloud/deepseek/chat/completions#

Символ # в конце отключает автоматическую конкатенацию — Cherry Studio использует URL как есть.

Настройка провайдера для Claude

В Cherry Studio откройте Settings → Model Services → + Add:

  • Provider Name: Ace Data Cloud - Claude
  • Provider Type: OpenAI
  • API Key: ваш токен Ace Data Cloud
  • API Address: https://api.acedata.cloud

Добавьте модели вручную через Model Management → + Add:

claude-opus-4-8
claude-sonnet-4-6
claude-haiku-4-5-20251001

Включите переключатель в правом верхнем углу — без этого модели не появятся в списке диалогов.

Настройка провайдера для GPT

Создайте второй провайдер:

  • Provider Type: OpenAI
  • API Key: тот же токен
  • API Address: https://api.acedata.cloud/openai/chat/completions#

Добавьте модели:

gpt-5.6-sol
gpt-5.5
gpt-4o
o3

Генерация изображений через gpt-4o-image

Cherry Studio не поддерживает кастомные провайдеры для панели «Рисование», но вы можете использовать gpt-4o-image прямо в диалоге. Эта модель принимает текстовый промпт и возвращает изображение в формате Markdown.

Добавьте gpt-4o-image в конфигурацию GPT-провайдера, включите для неё флаг «Visual» в Model Management, и прикрепляйте изображения в чат для редактирования.

Прямой вызов gpt-image-2 через curl

Модели gpt-image-2, nano-banana-pro, dall-e-3 используют формат Images API и недоступны в Cherry Studio. Вызывайте их напрямую:

curl https://api.acedata.cloud/openai/images/generations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A futuristic cityscape at sunset, cyberpunk style",
    "size": "2048x2048"
  }'

Поле size принимает строки вида WIDTHxHEIGHT, где обе стороны кратны 16, длинная сторона ≤ 3840, общее количество пикселей ≤ 8,294,400. Тарификация фиксирована за изображение, независимо от размера.

Python SDK для программной интеграции

Если вы интегрируете Ace Data Cloud в бэкенд, используйте OpenAI SDK:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_TOKEN",
    base_url="https://api.acedata.cloud"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "Explain quantum entanglement"}
    ]
)

print(response.choices[0].message.content)

Для GPT замените base_url на https://api.acedata.cloud/openai и укажите model="gpt-5.5".

Часто задаваемые вопросы

Ошибка token_mismatched: проверьте, что вы вставили токен из консоли Ace Data Cloud, а не из другого сервиса.

Модель не найдена (404): убедитесь, что API Address заканчивается на # для всех провайдеров, кроме Claude, и что ID модели совпадает с документацией.

Модель добавлена, но не видна в диалоге: включите переключатель провайдера в правом верхнем углу Settings → Model Services.

Резюме

Cherry Studio + Ace Data Cloud = единое окно для работы с Claude, GPT, Gemini и другими моделями. Один токен, одна консоль биллинга, прямое подключение. Полный список моделей и актуальные цены см. на платформе Ace Data Cloud.

Документация по Cherry Studio: docs.cherry-ai.com
Документация Ace Data Cloud: platform.acedata.cloud/documents

Comments

Post a Comment

Popular posts from this blog

Artistic QR Code API Integration Guidance

Image
Artistic QR code is an innovative technological product that combines QR codes with beautiful background images, creating practical and visually appealing works. They not only possess the functionality of traditional QR codes, allowing quick scanning and recognition by smart devices, but also incorporate artistic elements to enhance visual appeal and brand recognition. Some artistic QR codes are even generated by artificial intelligence, fully leveraging modern technology to demonstrate unparalleled innovation and uniqueness. This makes artistic QR codes widely applicable in areas such as brand marketing and advertising. In simple terms, artistic QR codes are the perfect combination of QR code scanning and artistic aesthetics. They not only provide the function of information transmission, but also enhance the user's visual experience, making each scan a delightful artistic enjoyment. Overview of Artworks Let's take a look at a few QR code works: How are they? These are ar...
Read more
Image
Nexior is an open-source project on GitHub that allows us to deploy our AI application site with one click, including AI Q&A, Midjourney drawing, knowledge base Q&A, artistic QR codes, and more. There is no need to develop AI systems, purchase AI accounts, worry about API support, or configure payment systems. It comes with zero startup costs and allows you to earn income through AI without risk. This article will introduce the deployment process of the Nexior project on Vercel. Without any programming skills, you can deploy your AI site in a few minutes and easily generate revenue. Preparation First, open the Nexior GitHub repository at: https://github.com/AceDataCloud/Nexior , then register or log in to your GitHub account. Click Fork to clone the code to your local repository, as shown below: After completing the Fork, we will get our personal repository, as shown below: In this example, the account is Germey, so we can see that we have Forked to the Germey user, wit...
Read more

How to Configure Claude Code with CC Switch and Ace Data Cloud

Image
If you use Claude Code across a terminal, VS Code, or remote development setup, the awkward part is often not the model itself but the configuration: where should requests go, where should the token live, and how do you switch providers without editing files by hand? This guide walks through a practical setup using CC Switch as the graphical configuration manager and Ace Data Cloud as the Anthropic-compatible base URL. The goal is simple: configure Claude Code once, verify the active endpoint, and keep the setup easy to change later. What you can do With the setup described in the Ace Data Cloud documentation, you can: Manage Claude Code provider configuration through a desktop UI instead of manually editing settings.json . Store an Ace Data Cloud provider with ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN . Switch the active Claude Code provider from CC Switch without rewriting your configuration every time. Use the same provider configuration from the terminal an...
Read more