API-reference

Brug disse REST-endepunkter fra Prompt Converter Cloud. Godkend med en Cloud API-nøgle efter abonnement.

Godkendelse

Send Authorization: Bearer pc_cloud_… eller headeren X-Api-Key. Opret nøgler på siden API-nøgler efter et aktivt Cloud-abonnement. Send ikke et Supabase-JWT.

Base-URL

I produktion bruges din Cloud-vært, f.eks. https://api.yourdomain.com. Lokalt: http://localhost:5000.

Fejl

Mislykkede anmodninger returnerer et JSON-objekt med en maskinlæsbar fejlkode og en valgfri besked.

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

Konvertér en prompt

POST /v1/convert

Konverterer rå tekst til en optimeret prompt til den valgte model. Tilgængelig på alle Cloud-planer og tæller med i den månedlige konverteringskvote.

Tilgængelig på: Alle Cloud-planer

Headers

Authorization string valgfri: Cloud API-nøgle Bearer pc_cloud_…. Påkrævet, medmindre X-Api-Key sendes.
X-Api-Key string valgfri: Cloud API-nøgle pc_cloud_…. Alternativ til Authorization.
Content-Type string påkrævet: Skal være application/json for JSON-bodies.

Body-parametre

rawInput string påkrævet: Teksten, der skal konverteres eller sendes som chat-tur.
targetModel string valgfri: Routingnøgle: gpt, claude, gemini eller grok. Standard er gpt.
openAiResultModel string valgfri: Valgfri OpenAI-model-id fra GET /v1/models, når targetModel er gpt.
claudeResultModel string valgfri: Valgfri Anthropic-model-id fra GET /v1/models, når targetModel er claude.
geminiResultModel string valgfri: Valgfri Gemini-model-id fra GET /v1/models, når targetModel er gemini.
grokResultModel string valgfri: Valgfri xAI Grok-model-id fra GET /v1/models, når targetModel er grok.

Eksempelanmodning

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"}'

Succes-svar

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

Fejl

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

Opret en chat-completion

POST /v1/chat

Kører en enkelt chat-tur med de samme modelfelter som convert. Kun Growth og Business. Tæller med i konverteringskvoten.

Tilgængelig på: Growth og Business

Headers

Authorization string valgfri: Cloud API-nøgle Bearer pc_cloud_…. Påkrævet, medmindre X-Api-Key sendes.
X-Api-Key string valgfri: Cloud API-nøgle pc_cloud_…. Alternativ til Authorization.
Content-Type string påkrævet: Skal være application/json for JSON-bodies.

Body-parametre

rawInput string påkrævet: Teksten, der skal konverteres eller sendes som chat-tur.
targetModel string valgfri: Routingnøgle: gpt, claude, gemini eller grok. Standard er gpt.
openAiResultModel string valgfri: Valgfri OpenAI-model-id fra GET /v1/models, når targetModel er gpt.
claudeResultModel string valgfri: Valgfri Anthropic-model-id fra GET /v1/models, når targetModel er claude.
geminiResultModel string valgfri: Valgfri Gemini-model-id fra GET /v1/models, når targetModel er gemini.
grokResultModel string valgfri: Valgfri xAI Grok-model-id fra GET /v1/models, når targetModel er grok.

Eksempelanmodning

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"}'

Succes-svar

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

Fejl

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

Vis modeller

GET /v1/models

Returnerer chat-, billede- og videomodeller med korte beskrivelser. Brug id som *ResultModel eller modelId.

Tilgængelig på: Growth og Business

Headers

Authorization string valgfri: Cloud API-nøgle Bearer pc_cloud_…. Påkrævet, medmindre X-Api-Key sendes.
X-Api-Key string valgfri: Cloud API-nøgle pc_cloud_…. Alternativ til Authorization.

Query-parametre

kind string valgfri: Valgfrit filter: chat, image eller video.

Eksempelanmodning

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

Succes-svar

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

Fejl

401 missing_authorization / invalid_api_key, 403 plan_required, 502 internal_error

Generér billeder

POST /v1/images

Genererer billeder synkront og returnerer signerede URL’er. Growth: 80 billeder pr. periode; Business: 300.

Tilgængelig på: Growth og Business

Headers

Authorization string valgfri: Cloud API-nøgle Bearer pc_cloud_…. Påkrævet, medmindre X-Api-Key sendes.
X-Api-Key string valgfri: Cloud API-nøgle pc_cloud_…. Alternativ til Authorization.
Content-Type string påkrævet: Skal være application/json for JSON-bodies.

Body-parametre

prompt string påkrævet: Genereringsprompt. Må ikke være tom.
modelId string påkrævet: Model-id fra GET /v1/models til den matchende type.
aspectRatio string valgfri: Valgfrit billedformat, f.eks. 1:1, 16:9, 9:16 eller 4:3.
count integer valgfri: Valgfrit antal billeder (1–4), hvis modellen tillader det.
quality string valgfri: Valgfri OpenAI-billedkvalitet: standard eller high.

Eksempelanmodning

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"}'

Succes-svar

{
  "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"
    }
  ]
}

Fejl

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

Generér en video

POST /v1/videos

Starter et videjob og returnerer HTTP 202 med jobId. Poll GET /v1/videos/{jobId}. Growth: 20 videoer; Business: 50.

Tilgængelig på: Growth og Business

Headers

Authorization string valgfri: Cloud API-nøgle Bearer pc_cloud_…. Påkrævet, medmindre X-Api-Key sendes.
X-Api-Key string valgfri: Cloud API-nøgle pc_cloud_…. Alternativ til Authorization.
Content-Type string påkrævet: Skal være application/json for JSON-bodies.

Body-parametre

prompt string påkrævet: Genereringsprompt. Må ikke være tom.
modelId string påkrævet: Model-id fra GET /v1/models til den matchende type.
aspectRatio string valgfri: Valgfrit billedformat, f.eks. 1:1, 16:9, 9:16 eller 4:3.
durationSeconds integer valgfri: Valgfri videovarighed i sekunder (typisk 4 eller 8).

Eksempelanmodning

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}'

Succes-svar

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

Fejl

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

Poll et videjob

GET /v1/videos/{jobId}

Returnerer status for et videjob ejet af API-nøglens bruger. Fuldførte jobs indeholder signerede URL’er.

Tilgængelig på: Growth og Business

Headers

Authorization string valgfri: Cloud API-nøgle Bearer pc_cloud_…. Påkrævet, medmindre X-Api-Key sendes.
X-Api-Key string valgfri: Cloud API-nøgle pc_cloud_…. Alternativ til Authorization.

Stiparametre

jobId uuid påkrævet: Job-id returneret af POST /v1/videos.

Eksempelanmodning

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

Succes-svar

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

Fejl

400 job_id_required, 401 missing_authorization, 403 plan_required, 404 job_not_found

Hent forbrug

GET /v1/usage

Returnerer konverterings- og medieforbrug for den aktuelle Cloud-periode, inkl. grænser.

Tilgængelig på: Alle Cloud-planer

Headers

Authorization string valgfri: Cloud API-nøgle Bearer pc_cloud_…. Påkrævet, medmindre X-Api-Key sendes.
X-Api-Key string valgfri: Cloud API-nøgle pc_cloud_…. Alternativ til Authorization.

Eksempelanmodning

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

Succes-svar

{
  "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
}

Fejl

401 missing_authorization / invalid_api_key, 502 internal_error

Sundhedstjek

GET /v1/health

Liveness-tjek. Kræver ingen API-nøgle.

Tilgængelig på: Offentlig (ingen API-nøgle)

Eksempelanmodning

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

Succes-svar

{ "status": "ok" }

Fejl

—