API-Schlüssel holen

von Kuaishou

Ein Bild in 720p oder 1080p animieren, optional mit Endbild

kling/2.1/image-to-videoAb 27 Creditsfür einen 5-Sekunden-Clip · 0,27 $
  • Bis 1080p
  • Clips mit 5–10 s
  • Start- und Endbild
  • Bild zu Video
Beispiele ansehen

Du rufst es mit dem Modellnamen kling/2.1/image-to-video über POST /jobs/createTask auf, ab 27 Credits für einen 5-Sekunden-Clip (0,27 $). Neue Konten bekommen 30 kostenlose Credits, damit du es zuerst im Playground testen kannst.

Modellnamekling/2.1/image-to-video
EndpunktPOST https://api.popnow.ai/api/v1/jobs/createTask
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "kling/2.1/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Der input ist aus dem Schema unten gebaut und besteht die Prüfung so, wie er dasteht. Ersetz Prompt und Links durch deine eigenen.

Preis

OptionCredits pro Sekunde≈ USD
resolution 720p5,250,053 $
resolution 1080p10,20,10 $

1 Credit = 0,01 $ · Alle Optionen und Preise: GET /models/kling/2.1/image-to-video

Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 27 Credits für einen 5-Sekunden-Clip (0,27 $).

Limits

Cliplänge
5–10 s
Auflösungen
720p · 1080p
Prompt-Länge (Zeichen)
5,000
Größter Upload
10 MB

Parameter

Diese Felder stammen aus demselben Schema, gegen das wir jede Anfrage prüfen. Nicht aufgeführte Felder werden abgelehnt.

  • promptstringPflicht

    Describe what happens after the opening frame: the action, the camera.

    Bereich
    1 – 5000 chars
  • image_urlstringPflicht

    Das Bild, von dem aus es losgeht.

    Bereich
    image/jpeg, image/png, image/webp, image/gif · ≤ 10 MB
  • last_image_urlstringOptional

    Optionales Endbild, damit der Clip genau dort endet, wo du willst.

    Bereich
    image/jpeg, image/png, image/webp, image/gif · ≤ 10 MB
  • resolutionstringOptionalÄndert den Preis

    Ausgabegröße. Größere Formate sind schärfer und kosten mehr.

    Standardwert
    "720p"
    Erlaubte Werte
    "720p""1080p"
  • duration_secondsintegerOptionalÄndert den Preis

    Wie lang der Clip läuft. Abgerechnet wird pro Sekunde.

    Standardwert
    5
    Erlaubte Werte
    510
  • negative_promptstringOptional

    Was du nicht sehen willst.

    Bereich
    0 – 500 chars
  • guidance_scalenumberOptional

    Wie streng das Modell dem Prompt folgt.

    Standardwert
    0.5
    Bereich
    0 – 1
Rohes JSON-Schema
{
  "additionalProperties": false,
  "properties": {
    "duration_seconds": {
      "default": 5,
      "description": "Output length: 5 or 10 seconds. Billed per second.",
      "enum": [
        5,
        10
      ],
      "type": "integer"
    },
    "guidance_scale": {
      "default": 0.5,
      "description": "How strictly the clip follows the prompt, from 0 to 1. Higher is more literal, lower gives the model more freedom.",
      "maximum": 1,
      "minimum": 0,
      "type": "number"
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Opening frame. The clip starts from this image. JPEG or PNG only.",
      "format": "uri",
      "type": "string"
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Optional closing frame the clip should end on. JPEG or PNG only.",
      "format": "uri",
      "type": "string"
    },
    "negative_prompt": {
      "description": "Things the clip should avoid, written as a short list.",
      "maxLength": 500,
      "type": "string"
    },
    "prompt": {
      "description": "Describe what happens after the opening frame: the action, the camera.",
      "maxLength": 5000,
      "minLength": 1,
      "type": "string"
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution. Higher tiers cost more per second.",
      "enum": [
        "720p",
        "1080p"
      ],
      "type": "string"
    }
  },
  "required": [
    "prompt",
    "image_url"
  ],
  "type": "object"
}

Ein echtes Ergebnis von Kling 2.1

PromptShe turns and walks slowly back along the pier toward the camera through the drifting fog, the wind catching her red scarf, and stops close to the lens, looking straight into it. The fog thins and the dawn light warms the water behind her.
Dieselbe Anfrage über die API
{
  "model": "kling/2.1/image-to-video",
  "input": {
    "prompt": "She turns and walks slowly back along the pier toward the camera through the drifting fog, the wind catching her red scarf, and stops close to the lens, looking straight into it. The fog thins and the dawn light warms the water behind her.",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1080p",
    "duration_seconds": 5
  }
}

Dieses Ergebnis startete mit einer hochgeladenen Datei: Setz deinen eigenen Link dort ein, wo der Beispiel-Link steht.

Antworten, Polling und Callbacks

Alle Modelle funktionieren gleich: Task anlegen, dann pollen oder auf den Callback warten.

Erst den Preis prüfen

cURL
curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/2.1/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

Gleicher Body wie bei createTask. Liefert die erwartete und die höchstmögliche Abbuchung und startet nichts.

Angenommen

HTTP
HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 heißt: Der Task ist angenommen, die Credits sind reserviert, aber noch nicht abgebucht. Die endgültige Abbuchung liegt nie über der Reservierung.

Status abfragen

cURL
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Frag alle paar Sekunden mit wachsendem Abstand ab und hör auf, sobald state succeeded, failed, canceled oder expired ist.

Fertiger Task

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "kling/2.1/image-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.mp4?signature=FROM_RESPONSE",
          "expiresAt": "2026-10-17T12:20:00Z",
          "mime": "video/mp4",
          "width": 1280,
          "height": 720,
          "durationSeconds": 5
        }
      ]
    },
    "settled": true
  },
  "request_id": "req_example_record"
}

Lad über die url vor expiresAt herunter. Später einen frischen Link nötig? Frag POST /common/download-url.

Callback prüfen

Node.js
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.header("X-Webhook-Timestamp");
  const signature = req.header("X-Webhook-Signature") ?? "";
  const body = JSON.parse(req.body.toString("utf8"));
  const taskId = body.data?.taskId ?? body.task_id;
  const digest = createHash("sha256").update(req.body).digest("hex");
  const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
    .update(`${taskId}.${timestamp}.${digest}`)
    .digest("base64");
  const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  // Check the signature first, then reject anything older than five minutes.
  if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
  res.status(200).end(); // answer fast, then fetch the task and store its files
});

Mit gesetzter callBackUrl schicken wir dir den fertigen Task. Prüf die Signatur am rohen Body, bevor du ihm vertraust.

Lokale Datei schicken

cURL
curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType": "image/png", "bytes": 482113}'

# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
  -H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.

Öffentliche https-Links funktionieren direkt. Lokale Dateien laufen vorher über upload-url und commit.