API-Dokumentation
Alles, was Sie brauchen, um API in One in Ihre Anwendung zu integrieren.
Authentifizierung
Alle API-Anfragen erfordern ein Bearer-Token im Authorization-Header. Sie können Ihre API-Schlüssel im Dashboard verwalten.
Authorization: Bearer aio_your_api_key_hereAPI-Schlüssel erhalten: Erstellen Sie Ihren kostenlosen API-Schlüssel auf der API-Schlüssel-Seite in Ihrem Dashboard. Neue Konten erhalten Bonusguthaben zum Erkunden der Plattform.
Basis-URL
https://apiin.one/api/v1API-Endpunkte
/api/v1/images/generations/api/v1/videos/generations/api/v1/audio/music/api/v1/audio/speech/api/v1/chat/completions/api/v1/images/tools/remove-bg/api/v1/tasks/{task_id}Anfrage-Format
Alle Anfragen verwenden einen JSON-Body mit einem erforderlichen 'model'-Feld zur Angabe des KI-Modells. Weitere Parameter variieren je nach Modell.
{
"model": "flux-2",
"prompt": "A beautiful landscape",
"...other_params": "..."
}Der Parameter 'model' ist immer erforderlich. Besuchen Sie die Dokumentationsseite jedes Modells für die vollständige Liste unterstützter Parameter.
Antwort-Format
Asynchrone Aufgaben (Bild, Video, Musik, Sprache)
Für Content-Generierungsmodelle gibt die API sofort eine Aufgaben-ID zurück. Fragen Sie den Status-Endpunkt ab, um zu prüfen, ob die Aufgabe abgeschlossen ist.
Initial response when task is created.
{
"id": "task_abc123",
"status": "pending",
"model": "kling-3",
"created_at": "2026-02-24T12:00:00Z"
}Synchrone Antworten (Chat)
Chat-Antworten werden direkt in einer einzelnen Anfrage zurückgegeben, im OpenAI-kompatiblen Format.
{
"id": "chatcmpl_xyz",
"model": "gemini",
"choices": [
{
"message": {
"role": "assistant",
"content": "..."
}
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 156,
"total_tokens": 168
},
"credits_consumed": 2
}Fehlerbehandlung
Alle Fehler werden in einem einheitlichen JSON-Format mit Fehlercode, Nachricht und Typ zurückgegeben.
{
"error": {
"code": 401,
"message": "Invalid API key",
"type": "authentication_error"
}
}| Status Code | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
400 | invalid_request | Optional | Ungültige Anfrageparameter. Prüfen Sie die Modelldokumentation auf erforderliche Felder. |
401 | authentication_error | Optional | API-Schlüssel fehlt, ist ungültig oder wurde widerrufen. |
402 | insufficient_credits | Optional | Ihr Konto hat nicht genügend Guthaben. Kaufen Sie weitere Credits, um fortzufahren. |
404 | not_found | Optional | Die angeforderte Ressource (Aufgabe, Modell) wurde nicht gefunden. |
429 | rate_limit | Optional | Ratenlimit überschritten. Standard sind 60 Anfragen pro Minute. |
500 | server_error | Optional | Interner Serverfehler. Bitte versuchen Sie es nach kurzer Verzögerung erneut. |
Schnellstart
1. API-Schlüssel erhalten
Registrieren Sie sich und erstellen Sie einen API-Schlüssel in Ihrem Dashboard. Kostenlose Konten erhalten Bonusguthaben.
2. Erste Anfrage senden
curl -X POST https://apiin.one/api/v1/images/generations \
-H "Authorization: Bearer aio_your_key" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2",
"prompt": "A serene Japanese garden with cherry blossoms"
}'3. Aufgabenstatus prüfen (asynchrone Modelle)
curl https://apiin.one/api/v1/tasks/task_abc123 \
-H "Authorization: Bearer aio_your_key"4. Weitere Modelle entdecken
Durchsuchen Sie unser Modellverzeichnis, um das perfekte KI-Modell für Ihren Anwendungsfall zu finden.
Alle Modelle durchsuchen →API Tester
Test the API directly from your browser: