Prompt Converter Cloud
Sprache: EN DE FR ES DA UK PL SV RU

API-Referenz

Nutzen Sie diese REST-Endpunkte von Prompt Converter Cloud. Authentifizieren Sie sich nach dem Abonnement mit einem Cloud-API-Schlüssel.

Authentifizierung

Senden Sie Authorization: Bearer pc_cloud_… oder den Header X-Api-Key. Schlüssel erstellen Sie auf der Seite API-Schlüssel nach einem aktiven Cloud-Abonnement. Senden Sie kein Supabase-JWT an diese Endpunkte.

Basis-URL

In der Produktion verwenden Sie Ihren Cloud-Host, zum Beispiel https://api.yourdomain.com. Lokal ist http://localhost:5000.

Fehler

Fehlgeschlagene Anfragen liefern ein JSON-Objekt mit einem maschinenlesbaren Fehlercode und einer optionalen Meldung.

{
  "error": "quota_exceeded",
  "message": "Optional human-readable detail"
}

Prompt konvertieren

POST /v1/convert

Wandelt Rohtext in einen optimierten Prompt für das gewählte Modell um. Auf jedem Cloud-Plan verfügbar und zählt zur monatlichen Konvertierungsquote.

Verfügbar für: Alle Cloud-Pläne

Header

Authorization string optional
Bearer pc_cloud_… Cloud-API-Schlüssel. Erforderlich, wenn kein X-Api-Key gesendet wird.
X-Api-Key string optional
pc_cloud_… Cloud-API-Schlüssel. Alternative zum Authorization-Header.
Content-Type string erforderlich
Muss für JSON-Bodies application/json sein.

Body-Parameter

rawInput string erforderlich
Der Text, der konvertiert oder als Chat-Nachricht gesendet wird.
targetModel string optional
Routing-Schlüssel: gpt, claude, gemini oder grok. Standard ist gpt.
openAiResultModel string optional
Optionale OpenAI-Modell-ID aus GET /v1/models, wenn targetModel gpt ist.
claudeResultModel string optional
Optionale Anthropic-Modell-ID aus GET /v1/models, wenn targetModel claude ist.
geminiResultModel string optional
Optionale Gemini-Modell-ID aus GET /v1/models, wenn targetModel gemini ist.
grokResultModel string optional
Optionale xAI-Grok-Modell-ID aus GET /v1/models, wenn targetModel grok ist.

Beispielanfrage

curl -X POST https://api.yourdomain.com/v1/convert \
  -H "Authorization: Bearer pc_cloud_..." \
  -H "Content-Type: application/json" \
  -d '{"rawInput":"Explain dependency injection in .NET","targetModel":"gpt"}'

Erfolgreiche Antwort

{
  "result": "You are a senior .NET architect...",
  "targetModel": "gpt",
  "resultModel": "gpt-5.6-luna"
}

Fehler

400 raw_input_required, 401 missing_authorization / invalid_api_key, 403 subscription_required, 429 quota_exceeded, 502 provider_failed

Chat-Completion erstellen

POST /v1/chat

Führt eine einstufige Chat-Completion mit denselben Modellfeldern wie convert aus. Nur Growth und Business. Zählt zur monatlichen Konvertierungsquote.

Verfügbar für: Growth und Business

Header

Authorization string optional
Bearer pc_cloud_… Cloud-API-Schlüssel. Erforderlich, wenn kein X-Api-Key gesendet wird.
X-Api-Key string optional
pc_cloud_… Cloud-API-Schlüssel. Alternative zum Authorization-Header.
Content-Type string erforderlich
Muss für JSON-Bodies application/json sein.

Body-Parameter

rawInput string erforderlich
Der Text, der konvertiert oder als Chat-Nachricht gesendet wird.
targetModel string optional
Routing-Schlüssel: gpt, claude, gemini oder grok. Standard ist gpt.
openAiResultModel string optional
Optionale OpenAI-Modell-ID aus GET /v1/models, wenn targetModel gpt ist.
claudeResultModel string optional
Optionale Anthropic-Modell-ID aus GET /v1/models, wenn targetModel claude ist.
geminiResultModel string optional
Optionale Gemini-Modell-ID aus GET /v1/models, wenn targetModel gemini ist.
grokResultModel string optional
Optionale xAI-Grok-Modell-ID aus GET /v1/models, wenn targetModel grok ist.

Beispielanfrage

curl -X POST https://api.yourdomain.com/v1/chat \
  -H "Authorization: Bearer pc_cloud_..." \
  -H "Content-Type: application/json" \
  -d '{"rawInput":"Explain dependency injection","targetModel":"gpt","openAiResultModel":"gpt-5.6-luna"}'

Erfolgreiche Antwort

{
  "result": "Dependency injection is a technique...",
  "targetModel": "gpt",
  "resultModel": "gpt-5.6-luna"
}

Fehler

400 raw_input_required, 401 missing_authorization / invalid_api_key, 403 plan_required, 429 quota_exceeded, 502 provider_failed

Modelle auflisten

GET /v1/models

Liefert Chat-, Bild- und Videomodelle mit kurzen Beschreibungen. Verwenden Sie id als *ResultModel oder modelId.

Verfügbar für: Growth und Business

Header

Authorization string optional
Bearer pc_cloud_… Cloud-API-Schlüssel. Erforderlich, wenn kein X-Api-Key gesendet wird.
X-Api-Key string optional
pc_cloud_… Cloud-API-Schlüssel. Alternative zum Authorization-Header.

Query-Parameter

kind string optional
Optionaler Filter: chat, image oder video.

Beispielanfrage

curl https://api.yourdomain.com/v1/models?kind=chat \
  -H "Authorization: Bearer pc_cloud_..."

Erfolgreiche Antwort

{
  "models": [
    {
      "id": "gpt-5.6-luna",
      "displayName": "GPT-5.6 Luna",
      "provider": "openai",
      "kind": "chat",
      "description": "Chat model",
      "targetModel": "gpt"
    }
  ]
}

Fehler

401 missing_authorization / invalid_api_key, 403 plan_required, 502 internal_error

Bilder erzeugen

POST /v1/images

Erzeugt Bilder synchron und gibt signierte URLs zurück. Growth: 80 Bilder pro Abrechnungszeitraum; Business: 300.

Verfügbar für: Growth und Business

Header

Authorization string optional
Bearer pc_cloud_… Cloud-API-Schlüssel. Erforderlich, wenn kein X-Api-Key gesendet wird.
X-Api-Key string optional
pc_cloud_… Cloud-API-Schlüssel. Alternative zum Authorization-Header.
Content-Type string erforderlich
Muss für JSON-Bodies application/json sein.

Body-Parameter

prompt string erforderlich
Prompt für die Generierung. Darf nicht leer sein.
modelId string erforderlich
Modell-ID aus GET /v1/models für die passende Art.
aspectRatio string optional
Optionales Seitenverhältnis, zum Beispiel 1:1, 16:9, 9:16 oder 4:3.
count integer optional
Optionale Bildanzahl (1–4), wenn das Modell mehrere erlaubt.
quality string optional
Optionale OpenAI-Bildqualität: standard oder high.

Beispielanfrage

curl -X POST https://api.yourdomain.com/v1/images \
  -H "Authorization: Bearer pc_cloud_..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A red balloon over a lake at dusk","modelId":"gpt-image-2","aspectRatio":"16:9"}'

Erfolgreiche Antwort

{
  "jobId": "11111111-1111-1111-1111-111111111111",
  "status": "completed",
  "kind": "image",
  "modelId": "gpt-image-2",
  "results": [
    {
      "storagePath": "user/job-0.png",
      "signedUrl": "https://...",
      "mimeType": "image/png"
    }
  ]
}

Fehler

400 prompt_required / model_not_allowed, 401 missing_authorization, 403 plan_required, 429 quota_exceeded, 502 provider_failed

Video erzeugen

POST /v1/videos

Startet einen Video-Job und antwortet mit HTTP 202 und jobId. Fragen Sie GET /v1/videos/{jobId} ab. Growth: 20 Videos; Business: 50.

Verfügbar für: Growth und Business

Header

Authorization string optional
Bearer pc_cloud_… Cloud-API-Schlüssel. Erforderlich, wenn kein X-Api-Key gesendet wird.
X-Api-Key string optional
pc_cloud_… Cloud-API-Schlüssel. Alternative zum Authorization-Header.
Content-Type string erforderlich
Muss für JSON-Bodies application/json sein.

Body-Parameter

prompt string erforderlich
Prompt für die Generierung. Darf nicht leer sein.
modelId string erforderlich
Modell-ID aus GET /v1/models für die passende Art.
aspectRatio string optional
Optionales Seitenverhältnis, zum Beispiel 1:1, 16:9, 9:16 oder 4:3.
durationSeconds integer optional
Optionale Videodauer in Sekunden (typisch 4 oder 8).

Beispielanfrage

curl -X POST https://api.yourdomain.com/v1/videos \
  -H "Authorization: Bearer pc_cloud_..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A red balloon drifting over a lake","modelId":"sora-2","aspectRatio":"16:9","durationSeconds":8}'

Erfolgreiche Antwort

{
  "jobId": "22222222-2222-2222-2222-222222222222",
  "status": "processing",
  "kind": "video",
  "modelId": "sora-2"
}

Fehler

400 prompt_required / model_not_allowed, 401 missing_authorization, 403 plan_required, 429 quota_exceeded, 502 provider_failed

Video-Job abfragen

GET /v1/videos/{jobId}

Gibt den Status eines Video-Jobs des API-Schlüssel-Inhabers zurück. Abgeschlossene Jobs enthalten signierte URLs.

Verfügbar für: Growth und Business

Header

Authorization string optional
Bearer pc_cloud_… Cloud-API-Schlüssel. Erforderlich, wenn kein X-Api-Key gesendet wird.
X-Api-Key string optional
pc_cloud_… Cloud-API-Schlüssel. Alternative zum Authorization-Header.

Pfadparameter

jobId uuid erforderlich
Job-ID aus POST /v1/videos.

Beispielanfrage

curl https://api.yourdomain.com/v1/videos/22222222-2222-2222-2222-222222222222 \
  -H "Authorization: Bearer pc_cloud_..."

Erfolgreiche Antwort

{
  "jobId": "22222222-2222-2222-2222-222222222222",
  "status": "completed",
  "kind": "video",
  "modelId": "sora-2",
  "results": [
    {
      "storagePath": "user/job.mp4",
      "signedUrl": "https://...",
      "mimeType": "video/mp4"
    }
  ]
}

Fehler

400 job_id_required, 401 missing_authorization, 403 plan_required, 404 job_not_found

Nutzung abrufen

GET /v1/usage

Liefert Konvertierungs- und Mediennutzung für den aktuellen Cloud-Abrechnungszeitraum inklusive Limits.

Verfügbar für: Alle Cloud-Pläne

Header

Authorization string optional
Bearer pc_cloud_… Cloud-API-Schlüssel. Erforderlich, wenn kein X-Api-Key gesendet wird.
X-Api-Key string optional
pc_cloud_… Cloud-API-Schlüssel. Alternative zum Authorization-Header.

Beispielanfrage

curl https://api.yourdomain.com/v1/usage \
  -H "Authorization: Bearer pc_cloud_..."

Erfolgreiche Antwort

{
  "used": 42,
  "limit": 5000,
  "planName": "growth",
  "periodStart": "2026-07-01T00:00:00Z",
  "periodEnd": "2026-08-01T00:00:00Z",
  "imagesUsed": 3,
  "imagesLimit": 80,
  "videosUsed": 1,
  "videosLimit": 20
}

Fehler

401 missing_authorization / invalid_api_key, 502 internal_error

Health-Check

GET /v1/health

Liveness-Prüfung. Kein API-Schlüssel erforderlich.

Verfügbar für: Öffentlich (kein API-Schlüssel)

Beispielanfrage

curl https://api.yourdomain.com/v1/health

Erfolgreiche Antwort

{ "status": "ok" }

Fehler

—