Skip to main content
POST
cURL
Bruk dette endepunktet til å opprette en Kling tekst-til-video-oppgave fra en prompt. Det starter en asynkron jobb i stedet for å returnere en ferdig video umiddelbart.

Første fungerende forespørsel

  • Send en kort prompt først
  • Start med eksempelet kling-v3, og velg deretter et annet model_name fra OpenAPI-enum når du trenger en annen modellbane
  • Legg til aspect_ratio, duration, mode eller sound først etter at den grunnleggende flyten fungerer
  • Sett callback_url hvis du vil ha push-levering i stedet for bare polling
  • Bruk sound: off når du vil ha en deterministisk første forespørsel uten lyd på modeller som støtter generert lyd

Modellnavngivning

Bruk vanlige Kling video model ID-er på dette endepunktet. Behold Omni model ID-er for Omni Video.

Varighet og sideforhold

Dette endepunktet eksponerer ikke en separat oppløsningstoken eller et eksakt size-felt. Det forespurte sideforholdet styrer formen på utdatarammen.

Oppgaveflyt

1

Send inn genereringsforespørselen

Opprett oppgaven via dette endepunktet og lagre den returnerte Kling oppgave-ID-en.
2

Poll oppgavetilstanden

Sjekk fremdriften via Hent en Kling-oppgave til oppgaven når en terminal tilstand.
3

Lagre resultatet

Når Kling returnerer metadata for den ferdige ressursen, flytt resultatet til din egen lagring hvis du trenger lang oppbevaring.
For den fullstendige parametermatrisen og detaljer om modellbaner, se den offisielle Kling-dokumentasjonen.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Overskrifter

Content-Type
string

Must be application/json.

Kropp

application/json
prompt
string
påkrevd

Text prompt describing the video to generate. Maximum 500 characters.

negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

aspect_ratio
enum<string>

Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field.

Tilgjengelige alternativer:
16:9,
9:16,
1:1
callback_url
string

Webhook URL to receive task status updates when the task completes.

model_name
enum<string>
standard:kling-v1

Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint.

Tilgjengelige alternativer:
kling-v1,
kling-v1-6,
kling-v2-master,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
cfg_scale
number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

mode
enum<string>
standard:std

Generation mode. std for standard (faster), pro for professional (higher quality). The default is std.

Tilgjengelige alternativer:
std,
pro
duration
string
standard:5

Output video length in seconds. Use 5 or 10; omit to use 5.

camera_control
object

Camera motion preset or manual configuration. Omit for automatic camera movement.

external_task_id
string

Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

Tilgjengelige alternativer:
on,
off

Svar

200 - application/json

Successful Response

code
integer

Error code; specifically define the error code

message
string

error message

request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object
Sist endret 3. juli 2026