> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Korzystanie z Ace Data Cloud w ChatBox

> Platform API guide - Ace Data Cloud

[ChatBox](https://chatboxai.app/) to otwartoźródłowy klient AI obsługujący Windows, macOS, Linux, iOS, Android i Web. Obsługuje niestandardowych dostawców typu „OpenAI API”, dlatego może bezpośrednio łączyć się z Ace Data Cloud. Ten artykuł przedstawia proces konfiguracji.

## Proces aplikowania

Aby połączyć Ace Data Cloud w ChatBox, najpierw przejdź do [konsoli Ace Data Cloud](https://platform.acedata.cloud/console/applications), pobierz swój API Token i zachowaj go do użycia.

![Uzyskiwanie Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

Jeśli nie jesteś jeszcze zalogowany lub zarejestrowany, zostaniesz automatycznie przekierowany na stronę logowania, aby się zarejestrować i zalogować, a po zalogowaniu i rejestracji automatycznie wrócisz na bieżącą stronę.

Przy pierwszym aplikowaniu otrzymasz bezpłatny limit, dzięki któremu możesz bezpłatnie wypróbować usługi modeli Ace Data Cloud.

## Pobieranie ChatBox

Przejdź na [oficjalną stronę ChatBox](https://chatboxai.app/), aby pobrać wersję dla swojej platformy, lub bezpośrednio użyj niewymagającej instalacji [wersji Web](https://web.chatboxai.app/):

* Komputery stacjonarne: Windows `.exe`, macOS `.dmg` (z rozróżnieniem Intel / Apple Silicon), Linux AppImage
* Urządzenia mobilne: App Store, Google Play, bezpośredni link do Androida na oficjalnej stronie

## Konfiguracja Ace Data Cloud

Uruchom ChatBox, przejdź do **Ustawienia → Modele → Dodaj niestandardowego Provider**, ustaw **API Mode** na **OpenAI API Compatible**, a następnie wypełnij:

| Pole | Wartość | Opis |
| - | - | - |
| Klucz API | Twój Ace Data Cloud Token | Token skopiowany z konsoli |
| API Host | `https://api.acedata.cloud` | Wypełnij tylko domenę główną, **nie dodawaj `/openai` ani `/v1`** |
| API Path | `/v1/chat/completions` | Domyślnie w ChatBox jest `/chat/completions`, należy ręcznie zmienić na to |

![Interfejs konfiguracji ChatBox Ace Data Cloud Provider](https://cdn.acedata.cloud/3789c8e3dd4d.png)

Ścieżka żądania ChatBox to `{API Host} + {API Path}`, dlatego w Host wystarczy wpisać tylko domenę główną:

| API Host | Końcowe żądanie | Wynik |
| - | - | - |
| `https://api.acedata.cloud` | `https://api.acedata.cloud/v1/chat/completions` | Poprawne |
| `https://api.acedata.cloud/openai` | `https://api.acedata.cloud/openai/v1/chat/completions` | 404 (pod `/openai` nie ma `/v1`) |
| `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/v1/chat/completions` | 404 |

ChatBox nie wywołuje automatycznie `/v1/models`; należy ręcznie wpisać ID modelu (po jednym w każdym wierszu) w polu „Niestandardowe modele” na dole strony ustawień modeli. Po zapisaniu będzie można wybrać go z rozwijanej listy modeli w interfejsie rozmowy. Przełączniki możliwości, okno kontekstowe i limit wyjścia muszą być wypełnione zgodnie z aktualną umową wybranego modelu, nie kopiuj wartości z innych modeli.

## Wybór modelu

Katalog modeli będzie stale aktualizowany. W pierwszej kolejności użyj listy modeli automatycznie ładowanej przez klienta; jeśli konieczne jest ręczne wypełnienie, najpierw wyślij żądanie `GET https://api.acedata.cloud/v1/models`, aby uzyskać aktualne ID modeli, a następnie wybierz zgodnie z obsługiwanymi przez klienta możliwościami kontekstu, obrazów i wywoływania narzędzi.

## Weryfikacja integracji

Jeśli nie masz pewności, czy problem dotyczy ChatBox, czy sieci, możesz najpierw bezpośrednio zweryfikować punkt końcowy za pomocą curl (zastąp `{token}` swoim Tokenem):

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/v1/chat/completions' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

Zwrócenie kompatybilnego z OpenAI obiektu `chat.completion` oznacza, że zarówno Token, jak i punkt końcowy są gotowe; jeśli zwrócony zostanie `HTTP 403 used_up`, oznacza to, że Token jest ważny, ale saldo jest niewystarczające — wystarczy doładować konto w [konsoli](https://platform.acedata.cloud/console/applications).

## Często zadawane pytania

### Komunikat 404 Not Found

Zwykle oznacza to, że do API Host dodano dodatkowo `/openai` lub `/v1`. W Host wpisz tylko `https://api.acedata.cloud`, a ścieżkę pozostaw domyślnemu `/v1/chat/completions`.

### Komunikat 401 / token\_mismatched

Potwierdź, że w „Kluczu API” wklejony jest Token Ace Data Cloud (bez prefiksu `Bearer`, bez dodatkowych spacji) oraz że saldo należącej do niego aplikacji jest wystarczające.

### Model nie jest widoczny na rozwijanej liście modeli

ChatBox nie pobiera automatycznie listy modeli; musisz ręcznie wpisać ID modelu w polu „Niestandardowe modele” i zapisać.

### Chcę generować obrazy w ChatBox

Generowanie obrazów Ace Data Cloud jest niezależnym Images API (`/openai/images/generations`) i używa innej ścieżki niż interfejs rozmowy, dlatego nie można bezpośrednio połączyć go z wejściem obrazów ChatBox. Jeśli chcesz tworzyć obrazy, zapoznaj się z [dokumentacją API generowania obrazów](https://platform.acedata.cloud/documents/openai-images-generations) i wywołaj je za pomocą curl / SDK.

## Dowiedz się więcej

* [Oficjalna strona ChatBox](https://chatboxai.app/) ｜ [ChatBox GitHub](https://github.com/chatboxai/chatbox)
* [Oficjalny przewodnik ChatBox dotyczący integracji usług kompatybilnych z OpenAI (BYOK)](https://chatboxai.app/en/guide/byok/openai)
* [Dokumentacja Ace Data Cloud OpenAI Chat Completions API](https://platform.acedata.cloud/documents/openai-chat-completions)
* [Dokumentacja Ace Data Cloud API generowania obrazów](https://platform.acedata.cloud/documents/openai-images-generations)
* [Lista usług Ace Data Cloud](https://platform.acedata.cloud/documents)
* [Konsola Ace Data Cloud](https://platform.acedata.cloud/console)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.