Video generation

# New video: preserve the requested duration and ratio.
curl https://apixly.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Create a new scene with the pictured character, using the reference video for camera movement.",
    "images": ["https://example.com/character.jpg"],
    "videos": ["https://example.com/reference.mp4"],
    "omni_reference_task_type": "reference",
    "duration": 10,
    "ratio": "16:9"
  }'

# Edit: 1–10 videos (4–30s each, <=30s combined), up to 30 images and 10 audio clips.
# The prompt selects the source: here @Video 2 is edited, @Video 1 is a supporting reference.
# A source video plus audio needs no additional image. Images/audio are forwarded together.
# POST /v1/video/edits remains an alias of the plural endpoint below.
curl https://apixly.ai/v1/videos/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Replace the character in @Video 2 with the character in @Image 1. Use @Video 1 as a reference for the background and @Audio 1 as the soundtrack. Preserve the timing and framing of @Video 2.",
    "videos": ["https://example.com/support-6s.mp4", "https://example.com/source-4s.mp4"],
    "images": ["https://example.com/character.jpg"],
    "audios": ["https://example.com/soundtrack.mp3"],
    "omni_reference_task_type": "edit",
    "duration": -1,
    "ratio": "adaptive",
    "resolution": "480p"
  }'
# input_seconds sums all input videos; audio seconds do not add to input_seconds/billed_seconds.
# The 4 + 6 second inputs reserve 10 input + ceil(10) output = 20 billed seconds.
# Reservation and settlement share the same rules and frozen rates; actual metering replaces estimates.
# Per-second: billed_seconds = actual_output_seconds + max(input_seconds, ceil(2 * actual_output_seconds / 3)).
# Token pricing uses upstream usage.completion_tokens with the same with_ref SKU.
# Actual output follows the prompt-selected source; after generation the difference is refunded/charged.

# Wan video reference: no accompanying image or mode is required.
# Both wan3.0-video and wan3.0-video-prime accept the same fields.
# Use public MP4/MOV URLs; up to 5 clips, each 1–15s, at most 15s combined.
# Input-video seconds + output seconds must not exceed 30s.
curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "Use 视频1 as the reference for camera movement; create a new cinematic forest scene.",
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "videos": ["https://example.com/source-3s.mp4"]
  }'
# For editing: use one video and describe the change in the prompt, e.g.
# "Transform 视频1 into a clay animation while preserving its composition."
# For extension: describe continuing 视频1 and use ratio=adaptive.
# These Wan requests use /v1/videos; omni_reference_task_type is for Seedance 2.5.

# Wan content form: reference image + video + audio, with explicit roles.
# Do not combine content with flat image/images/video/videos/audio/audios fields.
# prompt may be omitted when content contains text. Per-type numbering starts at 1.
curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "content": [
      {"type": "text", "text": "Animate the character in 图1 using the camera movement in 视频1 and the voice in 音频1."},
      {"type": "image_url", "image_url": {"url": "https://example.com/character.jpg"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/camera-3s.mp4"}, "role": "reference_video"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/voice-3s.mp3"}, "role": "reference_audio"}
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false,
    "seed": 0
  }'
# content is also supported on /v1/video/generations.
# Audio-only Wan references are accepted too; no image/video is required.

# Wan first/last frames: last_frame requires first_frame.
# Do not add reference images, videos or audio to this request.
curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "A flower gradually opens between the first and last frame.",
    "first_frame": "https://example.com/closed.jpg",
    "last_frame": "https://example.com/open.jpg",
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive",
    "generate_audio": false
  }'
# Equivalent content roles: first_frame and last_frame.
# Plain images[] means reference_image for Wan; use explicit frame fields/roles.
# Wan defaults: duration=5, resolution=720p (gateway), ratio=adaptive,
# generate_audio=true, watermark=false. duration=-1 requests automatic duration.

curl https://apixly.ai/v1/video/config \
  -H "Authorization: Bearer YOUR_API_KEY"
# => {"object":"list","data":[
#   {"object":"video_model","model":"seedance-2.0",
#    "modes":["text2video","image2video","frames2video"],
#    "resolutions":["480p","720p","1080p"],"max_input_images":3,
#    "supports_reference_video":true,"supports_reference_audio":true,
#    "seconds":{"min":3,"max":12}}
# ]}
# Capabilities vary by model AND by account configuration — ALWAYS trust your own
# /v1/video/config response, not the sample values above.
# "resolutions" may list "4k" — in requests, "4k" and "2160p" are equivalent.

curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A golden retriever puppy running on a sunny beach, cinematic",
    "seconds": "5",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
# => {"id":"...","object":"video","status":"queued","progress":0,"seconds":"5"}

curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "mode": "image2video",
    "prompt": "The cat slowly turns its head and smiles",
    "image": "https://example.com/cat.png",
    "seconds": "5",
    "resolution": "720p"
  }'

# First/last-frame mode: mode = "frames2video" + EXACTLY 2 reference images,
# in order [first_frame, last_frame]. Any other count fails validation.
curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "smooth cinematic transition from day to night",
    "mode": "frames2video",
    "images": ["https://example.com/first.jpg", "https://example.com/last.jpg"]
  }'

curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "mode": "image2video",
    "prompt": "the cat dances breakdance strictly to the attached reference music — use the reference audio as the soundtrack, every move on its rhythm",
    "images": ["https://example.com/cat.jpg"],
    "audios": ["https://example.com/music.mp3"],
    "seconds": "6",
    "resolution": "480p"
  }'

curl https://apixly.ai/v1/videos/VIDEO_ID \
  -H "Authorization: Bearer YOUR_API_KEY"
# status: queued -> in_progress -> completed | failed
# on completion the response carries a temporary public URL (~30 min)

{
  "id": "video_01ABC...",
  "object": "video",
  "status": "completed",
  "progress": 100,
  "seconds": "5",
  "url": "<TEMPORARY_DOWNLOAD_URL>"
}

{
  "id": "video_01ABC...",
  "object": "video",
  "status": "failed",
  "error": {
    "code": "content_rejected",
    "message": "OutputVideoSensitiveContentDetected: The request failed because the output video may contain sensitive information"
  }
}

curl -L -o result.mp4 \
  "https://apixly.ai/v1/videos/VIDEO_ID/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

# List your own video tasks (newest first). Query: page (default 1),
# page_size (1-100, default 20), status, provider — all optional.
curl "https://apixly.ai/v1/videos?page=1&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
# => {"object":"list","data":[<same objects as GET /v1/videos/{id}>],
#     "total":42,"page":1,"page_size":20}
# Completed entries include their download "url".
# GET /v1/video/generations is an exact alias of GET /v1/videos.

curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "a paper boat drifting on a calm pond",
    "seconds": "6",
    "resolution": "480p",
    "callback_url": "https://your-server.example.com/webhooks/video"
  }'

// POST to your callback_url on the terminal state. Headers we send:
//   Content-Type: application/json        User-Agent: sub2api-webhook/1.0
//   X-Webhook-Signature: t=<unix>,v1=<hex hmac>   X-Webhook-Attempt: 1..4
// completed:
{
  "object": "video",
  "task_id": "123",
  "id": "123",
  "model": "grok-imagine-video",
  "status": "completed",
  "created_at": 1785772215,
  "completed_at": 1785772250,
  "url": "https://apixly.ai/v1/videos/content?ref=..."   // valid 30 min from delivery
}
// failed:
{
  "object": "video",
  "task_id": "124",
  "status": "failed",
  "created_at": 1785772215,
  "completed_at": 1785772300,
  "error": { "code": "upstream_error", "message": "..." }
}

# Optional: verify X-Webhook-Signature (recommended — reject unsigned
# requests and stale timestamps if you enable verification).
import hashlib, hmac, time

def verify(header: str, body: bytes, api_key: str, max_age: int = 300) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, v1 = parts.get("t", ""), parts.get("v1", "")
    if not t or not v1:
        return False
    if abs(time.time() - int(t)) > max_age:  # replay protection
        return False
    mac = hmac.new(api_key.encode(), f"{t}.".encode() + body, hashlib.sha256)
    return hmac.compare_digest(mac.hexdigest(), v1)

{
  "id": "video_01ABC...",
  "object": "video",
  "model": "seedance-2.5",
  "status": "completed",
  "progress": 100,
  "seconds": "3.712",
  "sku": "480p_with_ref",
  "usage": {"completion_tokens": 131702},
  "input_seconds": 10,
  "billed_seconds": 13.712,
  "settlement_status": "settled",
  "url": "<TEMPORARY_DOWNLOAD_URL>"
}

# Python 3 standard library: submit once, poll for at most 10 minutes, download.
# Keep video-request.json if interrupted; never restart by automatically POSTing again.
# For an intentional new generation, choose a new receipt filename below.
import json, pathlib, time, urllib.parse, urllib.request, uuid

BASE = "https://apixly.ai"
API_KEY = "YOUR_API_KEY"
payload = {"model": "seedance-2.0", "prompt": "a paper boat drifting down a rainy street, cinematic",
           "seconds": "5", "resolution": "720p"}
receipt = {"client_request_id": uuid.uuid4().hex, "request": payload}
receipt_path = pathlib.Path("video-request.json")
job_id = None

def preserve_receipt():
    receipt_path.write_text(json.dumps(receipt, indent=2), encoding="utf-8")

def request_json(url, data=None, timeout=30):
    headers = {"Authorization": "Bearer " + API_KEY}
    if data is not None:
        headers["Content-Type"] = "application/json"
    req = urllib.request.Request(url, data=json.dumps(data).encode() if data is not None else None,
                                 headers=headers)
    with urllib.request.urlopen(req, timeout=timeout) as response:
        request_id = response.headers.get("X-Request-ID")
        if request_id:
            receipt.setdefault("request_id", request_id)
            receipt["last_request_id"] = request_id
            preserve_receipt()
            print("request_id=" + request_id)
        result = json.loads(response.read())
    if not isinstance(result, dict):
        raise ValueError("Malformed task response")
    return result

try:
    if receipt_path.exists():
        previous = json.loads(receipt_path.read_text(encoding="utf-8"))
        if isinstance(previous, dict):
            receipt = previous
            job_id = previous.get("job_id")
        raise RuntimeError("An existing request receipt must be reconciled before a new submission")
    print("client_request_id=" + receipt["client_request_id"])
    preserve_receipt()  # Save a local marker before a possibly ambiguous submission.
    task = request_json(BASE + "/v1/videos", payload)
    job_id = task.get("id")
    if not isinstance(job_id, str) or not job_id.strip() or job_id.strip().lower() in ("null", "none"):
        raise ValueError("Submission did not return a usable job ID")
    job_id = job_id.strip()
    receipt["job_id"] = job_id
    preserve_receipt()
    print("job_id=" + job_id)
    deadline = time.monotonic() + 600
    for attempt in range(121):
        status = task.get("status")
        print("status=" + str(status))
        if status == "completed":
            result_url = task.get("url")
            if not isinstance(result_url, str):
                raise ValueError("Completed task has no download URL; query this job again")
            parsed = urllib.parse.urlsplit(result_url)
            if parsed.scheme not in ("http", "https") or not parsed.hostname or parsed.username or parsed.password:
                raise ValueError("Invalid download URL")
            with urllib.request.urlopen(result_url, timeout=60) as response:
                content_type = response.headers.get("Content-Type", "").split(";")[0].strip()
                if content_type and not (content_type.startswith("video/") or content_type == "application/octet-stream"):
                    raise ValueError("Download did not return video content")
                video = response.read()
            if not video:
                raise ValueError("Empty video download")
            pathlib.Path("result.mp4").write_bytes(video)
            print("Saved result.mp4; job_id=" + job_id)
            break
        if status == "failed":
            raise RuntimeError("Generation failed: " + json.dumps(task.get("error", {})))
        if status not in ("queued", "in_progress"):
            raise ValueError("Unknown or missing task status")
        remaining = deadline - time.monotonic()
        if attempt == 120 or remaining <= 0:
            raise TimeoutError("Local polling limit reached")
        if attempt:
            time.sleep(min(5, remaining))
        remaining = deadline - time.monotonic()
        if remaining <= 0:
            raise TimeoutError("Local polling limit reached")
        task = request_json(BASE + "/v1/videos/" + urllib.parse.quote(job_id, safe=""), timeout=min(30, remaining))
except Exception as error:
    raise SystemExit("client_request_id=" + str(receipt.get("client_request_id", "unknown")) + "; job_id=" + str(job_id) +
                     "; " + str(error) + ". Keep " + str(receipt_path) + " and query the existing job or contact support. Do not auto-resubmit.")

# Use case: remix a reference video — add the character from the image, dance to the attached music.
# Note how the prompt explicitly references ALL three attached materials in natural language.
curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "mode": "image2video",
    "prompt": "add the orange cat from the reference image into the reference video. the animals dance breakdance strictly to the attached reference music — use the reference audio as the soundtrack, every move on its rhythm",
    "images": ["https://example.com/cat.jpg"],
    "videos": ["https://example.com/dance.mp4"],
    "audios": ["https://example.com/music.wav"],
    "seconds": "6",
    "resolution": "480p",
    "aspect_ratio": "9:16"
  }'

# Use case: continue an existing clip (video extension) — supported models only
curl https://apixly.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "continue the scene: the camera slowly pulls back to reveal the whole valley at sunset",
    "videos": ["https://example.com/source.mp4"],
    "seconds": "8",
    "resolution": "720p"
  }'

curl https://apixly.ai/v1/videos/assets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5","URL":"https://example.com/source.mp4","AssetType":"Video","Name":"source"}'
# Poll with the same key until data.status=Active; use returned data.ref.
curl https://apixly.ai/v1/videos/assets/ASSET_ID -H "Authorization: Bearer YOUR_API_KEY"