Ein xAI-Video erstellen

POST

grok

videos

generations

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Animate the still image with a slow camera move and natural motion.",
    "image": {"url": "https://your-image-host/source.jpg"},
    "duration": 1,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

{
  "request_id": "<request_id>"
}

Verwenden Sie diesen Endpoint, um einen Grok-Bild-zu-Video-Job aus einem Quellbild und einem Prompt zu starten. Er gibt sofort eine request_id zurück, behandeln Sie ihn also als ersten Schritt in einem asynchronen Workflow.

Mit einer kleinen Anfrage beginnen

Verwenden Sie model: grok-imagine-video-1.5
Setzen Sie image.url auf eine öffentliche JPEG-, PNG- oder WebP-URL
Behalten Sie für eine erste Anfrage duration auf 1 und resolution auf 720p
Halten Sie prompt eindeutig, damit die Animationsrichtung klar ist
Wenn Sie base64 senden, behalten Sie in den Docs und im OpenAPI-Beispielformat die Form data:image/png;base64,<BASE64_IMAGE_DATA> bei

Dauer und Auflösung

Einstellung	Unterstützte Werte	Standard	Verhalten an den Grenzen
`duration`	Ganzzahl `1`-`15`	`8`	Verwenden Sie für erste Tests kürzere Clips; längere Clips kosten mehr und brauchen länger bis zur Fertigstellung.
`resolution`	`480p`, `720p`, `1080p`	`720p` in den Beispielen	Anfragen mit höherer Auflösung kosten mehr und brauchen länger bis zur Fertigstellung.
`aspect_ratio`	Seitenverhältnis-Bezeichnungen wie `1:1`, `16:9` oder `9:16`	`16:9` in den Beispielen	Dieser Endpoint verwendet `resolution` plus `aspect_ratio`; senden Sie kein separates Feld `size` für eine exakte Steuerung von `WxH`.

Anfragekombination	Beabsichtigte Ausgabe `WxH`
`resolution: 480p`, `aspect_ratio: 1:1`	`480x480`
`resolution: 720p`, `aspect_ratio: 16:9`	`1280x720`
`resolution: 720p`, `aspect_ratio: 9:16`	`720x1280`

Aufgabenablauf

Job erstellen

Senden Sie den Prompt und das Quellbild und speichern Sie dann die zurückgegebene request_id.

Polling bis zur Fertigstellung

Rufen Sie xAI-Videoergebnisse abrufen auf, bis der verschachtelte Provider-Status done wird.

Die Ausgabe speichern

Kopieren Sie die endgültige video.url in Ihren eigenen Speicher, wenn Sie sie nach dem temporären Bereitstellungsfenster des Providers benötigen.

Autorisierungen

Authorization

string

header

erforderlich

Bearer token authentication. Use your CometAPI key.

Body

application/json

prompt

string

erforderlich

Prompt describing how the source image should animate. CometAPI requires this field for this route.

Beispiel:

"Animate the still image with a slow camera move and natural motion."

aspect_ratio

enum<string>

Output aspect ratio. Combine with resolution to choose the target frame; for example 480p with 1:1 targets 480x480, 720p with 16:9 targets 1280x720, and 720p with 9:16 targets 720x1280. This endpoint does not expose an exact size field.

Verfügbare Optionen:

1:1,

16:9,

9:16,

4:3,

3:4,

3:2,

2:3

duration

integer

Standard:8

Output duration in seconds. Use an integer from 1 through 15. If omitted, CometAPI treats the request as an 8-second generation for billing and default handling.

image

object

Source image for image-to-video. Use a public JPEG, PNG, or WebP URL, or a data URI such as data:image/png;base64,<BASE64_IMAGE_DATA>.

Show child attributes

model

string

Standard:grok-imagine-video-1.5

xAI video model id. The default example uses Grok Imagine 1.5 for image-to-video.

Beispiel:

"grok-imagine-video-1.5"

output

object

Show child attributes

resolution

enum<string>

Standard:720p

Output resolution. Use 720p for a small image-to-video test, or 1080p when you need a higher resolution tier.

Verfügbare Optionen:

480p,

720p,

1080p

size

string

Deprecated size field. Prefer aspect_ratio and resolution.

user

string

Optional end-user identifier.

Antwort

200 - application/json

Request accepted.

request_id

string

erforderlich

Deferred request id used for polling.

Wan-Videoinhalte herunterladen

Zurück

Ein xAI-Videobearbeitung erstellen

Weiter

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Animate the still image with a slow camera move and natural motion.",
    "image": {"url": "https://your-image-host/source.jpg"},
    "duration": 1,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

{
  "request_id": "<request_id>"
}

Inhaltsmoderation

API-Schlüssel

Mit einer kleinen Anfrage beginnen

Dauer und Auflösung

Aufgabenablauf

Autorisierungen

Body

Antwort

​Mit einer kleinen Anfrage beginnen

​Dauer und Auflösung

​Aufgabenablauf

Autorisierungen

Body

Antwort

Mit einer kleinen Anfrage beginnen

Dauer und Auflösung

Aufgabenablauf