Video Edit

wan2.7-videoedit

Wan 2.7 video editing and style transfer.

POST /v1/videos/editsAsync generation

Quick start

Submit a request with this public model ID. The API immediately returns a normalized job; poll GET /v1/jobs/{jobId} while its status is queued or running.

curl -X POST "https://api.artany.ai/v1/videos/edits" \
  -H "Authorization: Bearer $ARTANY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{"model":"wan2.7-videoedit","video_urls":["https://example.com/source.mp4"],"prompt":"Replace the background with a snowy mountain landscape","resolution":"1080P","duration":5,"prompt_extend":true,"meta_data":{"audio_setting":"auto"}}'

Request

Headers

HeaderRequiredDescription
AuthorizationYesBearer token for an Artany API key.
Content-TypeYesMust be application/json.
Idempotency-KeyRecommended8–128 characters. Reusing it with an identical request prevents duplicate jobs and charges.

Body

{
  "model": "wan2.7-videoedit",
  "video_urls": [
    "https://example.com/source.mp4"
  ],
  "prompt": "Replace the background with a snowy mountain landscape",
  "resolution": "1080P",
  "duration": 5,
  "prompt_extend": true,
  "meta_data": {
    "audio_setting": "auto"
  }
}

Request Parameters

Only fields in this model’s public request contract are shown. Defaults are applied before validation and quoting.

Note:Video-editing workflow. Provide the source video, then describe the requested change.

modelstringrequireddefault: "wan2.7-videoedit"

Stable public model ID for this request.

video_urlsarray<string>required

Source video array for the edit operation.

Items: 1–1

Note:Provide a source video for a video-edit request.

promptstring

Instruction describing the requested modification to the source video.

Length: 1–5000

negative_promptstring

Content or visual characteristics to avoid.

Length: 1–500

image_urlsarray<string>

Optional image references that guide the requested edit.

Items: 1–4

resolutionstringdefault: "1080P"

Output resolution tier.

Allowed: 720P, 1080P

720P1080P
durationinteger

Requested output duration when supported by the selected edit configuration.

Range: 2–10

sizestring

Output framing for the edited video.

Allowed: 16:9, 9:16, 1:1, 4:3, 3:4

16:99:161:14:33:4
prompt_extendbooleandefault: true

Whether to enrich the edit prompt before processing.

seedinteger

Optional seed that influences generation randomness.

Range: 0–∞

meta_dataobjectdefault: {"audio_setting":"auto"}

Optional structured metadata supported by the selected edit path.

Use Cases

Choose the request shape that matches the source media you provide. The examples use the public model ID and accepted public fields.

Video edit

Provide the source video and describe the desired change.

{
  "model": "wan2.7-videoedit",
  "prompt": "Replace the background with a snowy mountain landscape",
  "video_urls": [
    "https://example.com/source.mp4"
  ],
  "duration": 5,
  "resolution": "1080P"
}

Response and task status

A successful asynchronous submission returns HTTP 202 with a supplier-neutral job.

{
  "id": "job_…",
  "object": "generation.job",
  "model": "wan2.7-videoedit",
  "status": "queued",
  "progress": 0,
  "output": null,
  "error": null,
  "billing": {
    "estimated_credits": "…",
    "frozen_credits": "…",
    "charged_credits": "0",
    "state": "frozen",
    "price_version": "2026-07-18.picverse-parity"
  },
  "created_at": "2026-07-21T00:00:00.000Z",
  "completed_at": null
}
  • queued / running: continue polling.
  • succeeded: retrieve media URLs from output; billing has settled.
  • failed / canceled: inspect error; frozen Credits are released.