Интеграция Ace Data Cloud с Cherry Studio: Полное руководство

Интеграция Ace Data Cloud с Cherry Studio: Полное руководство

Cherry Studio — это кроссплатформенный AI-клиент с открытым исходным кодом, поддерживающий работу с несколькими моделями через единый интерфейс. Благодаря возможности добавления пользовательских провайдеров, совместимых с OpenAI API, вы можете интегрировать Ace Data Cloud и получить доступ к Claude, GPT, Gemini и другим моделям через один API-токен.

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

При работе с Cherry Studio разработчики часто сталкиваются с необходимостью управлять несколькими API-ключами от разных провайдеров. Каждый сервис требует отдельной регистрации, настройки биллинга и мониторинга квот. Ace Data Cloud решает эту проблему, предоставляя единую точку доступа к множеству моделей.

Основные преимущества:

  • Единый токен для Claude Opus/Sonnet/Haiku, GPT-5/4o, Gemini, Grok, Kimi, GLM, DeepSeek
  • Консолидированный биллинг с детализацией по токенам и запросам
  • Прямое подключение без необходимости настройки прокси
  • Бесплатная квота для новых пользователей

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

Перейдите в консоль Ace Data Cloud и создайте новое приложение. При первой регистрации вам будет предоставлена бесплатная квота для тестирования сервиса.

Скопируйте сгенерированный API Token — он понадобится для настройки Cherry Studio.

Архитектура точек доступа

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

  • Claude использует дефолтный путь: https://api.acedata.cloud (без #)
  • Остальные семейства требуют полного URL с # на конце
  • Claude: https://api.acedata.cloud | claude-opus-4-8, claude-sonnet-4-6
  • GPT: https://api.acedata.cloud/openai/chat/completions# | gpt-5.6-sol, gpt-5.5-pro, gpt-4o
  • Gemini: https://api.acedata.cloud/gemini/chat/completions# | gemini-3.1-pro, gemini-2.5-pro
  • Grok: https://api.acedata.cloud/grok/chat/completions# | grok-4, grok-3

Настройка провайдера в Cherry Studio

Шаг 1: Добавление провайдера

1. Откройте Настройки (иконка шестерёнки) в Cherry Studio

2. Перейдите на вкладку Сервисы моделей

3. Нажмите + Добавить

4. Заполните поля:

- Имя провайдера: Ace Data Cloud - Claude

- Тип провайдера: OpenAI

5. Нажмите Добавить

Шаг 2: Конфигурация

Откройте созданного провайдера и настройте:

  • Включить переключатель (обязательно!)
  • API Key: вставьте токен из консоли Ace Data Cloud
  • API Address: https://api.acedata.cloud
  • Управление моделями: добавьте ID моделей вручную

Пример для Claude:

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

Конфигурация для GPT

Создайте отдельного провайдера:

  • API Address: https://api.acedata.cloud/openai/chat/completions#
  • Модели: gpt-5.6-sol, gpt-5.5-pro, gpt-5.4, gpt-4o, o3

Важно: символ # в конце обязателен, иначе Cherry Studio добавит лишний /v1/chat/completions.

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

Cherry Studio не поддерживает добавление пользовательских провайдеров для панели «Рисование», но вы можете использовать gpt-4o-image — модель, которая генерирует изображения через формат chat-completion.

Настройка:

1. В провайдере GPT добавьте модель gpt-4o-image

2. Создайте новый диалог и выберите эту модель

3. Отправьте текстовый промпт — изображение вернётся в формате Markdown ![](URL)

Чтобы редактировать существующее изображение, прикрепите его к сообщению (Cherry Studio отправит его как image_url). Убедитесь, что в настройках модели включена опция «Визуальные способности».

curl-пример для gpt-4o-image

curl https://api.acedata.cloud/openai/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-image",
    "messages": [
      {
        "role": "user",
        "content": "Vintage travel poster of the Amalfi Coast, art-deco style"
      }
    ]
  }'

Ответ содержит URL изображения в поле choices[0].message.content.

Специализированные модели изображений

Для продвинутой генерации используйте специализированные модели через Images API:

  • gpt-image-2, gpt-image-1.5, gpt-image-1
  • nano-banana-pro, nano-banana-2, nano-banana-2-lite

Endpoint: https://api.acedata.cloud/openai/images/generations

Пример для gpt-image-2:

curl https://api.acedata.cloud/openai/images/generations \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Cyberpunk cityscape at night, neon lights, rain-soaked streets",
    "size": "2048x1152"
  }'

Доступные разрешения:

  • 1:1: 1024x1024, 2048x2048, 2880x2880
  • 16:9: 1792x1024, 2048x1152, 3840x2160
  • 9:16: 1024x1792, 1152x2048, 2160x3840

Ограничения:

  • Стороны изображения должны быть кратны 16
  • Длинная сторона ≤ 3840 пикселей
  • Общее количество пикселей ≤ 8,294,400
  • Параметр n игнорируется (всегда возвращается 1 изображение)

Python SDK для автоматизации

Для интеграции в приложения используйте OpenAI SDK:

from openai import OpenAI

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

# Текстовая генерация с Claude
response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "Explain event-driven architecture"}
    ]
)
print(response.choices[0].message.content)

# Генерация изображения с gpt-4o-image
image_response = client.chat.completions.create(
    model="gpt-4o-image",
    messages=[
        {"role": "user", "content": "Abstract geometric pattern, bauhaus style"}
    ]
)
# URL изображения будет в content
print(image_response.choices[0].message.content)

Для специализированных моделей изображений:

image = client.images.generate(
    model="gpt-image-2",
    prompt="Minimalist product photography of a ceramic vase",
    size="2048x2048"
)
print(image.data[0].url)

Мониторинг использования и расходов

Все запросы отслеживаются в реальном времени:

Биллинг осуществляется по фактическому потреблению токенов (для текстовых моделей) или количеству изображений (для генеративных моделей). Стоимость каждого запроса детализируется с точностью до миллисекунд и input/output токенов.

Типичные ошибки и решения

`token_mismatched` или `invalid_token`

Проверьте, что в поле API Key указан именно токен Ace Data Cloud из консоли, а не ключ другого провайдера. Убедитесь, что у приложения достаточный баланс.

Модель не найдена / `api_not_implemented`

Причины:

  • Модель GPT отправлена на Claude-эндпоинт (или наоборот)
  • Забыли добавить # в конце URL для non-Claude провайдеров
  • Опечатка в названии модели (например, gpt-5.5pro вместо gpt-5.5-pro)

Решение: создайте отдельных провайдеров для каждого семейства согласно таблице выше.

Модель добавлена, но не появляется в селекторе

Проверьте, что переключатель «Включить» в правом верхнем углу страницы провайдера активирован. Cherry Studio скрывает модели отключённых провайдеров.

Нет кнопки загрузки изображения для gpt-4o-image

В Cherry Studio откройте Управление моделями → найдите gpt-4o-image → включите опцию Визуальные способности. После этого в диалоге появится кнопка прикрепления изображений.

Дополнительные ресурсы

Заключение

Интеграция Ace Data Cloud с Cherry Studio даёт вам единую точку доступа к ведущим AI-моделям без необходимости управления множеством API-ключей и биллинговых аккаунтов. Один токен, одна консоль мониторинга, множество возможностей — от Claude Opus для сложных рассуждений до gpt-image-2 для высококачественной генерации изображений.

Начните работу с бесплатной квотой на platform.acedata.cloud и убедитесь, насколько проще может быть работа с AI-моделями.

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