(Google) Veo 3 Video Gen

version: 1.0.1 publisher: Pixwith AI homepage: https://pixwith.ai

categories: - video-generation - ai-tools

tags: - pixwith - veo - video-generation - text-to-video - image-to-video

env: PIXWITH_API_KEY: required: true description: Pixwith API key used to authenticate API requests.

permissions: network: domains: - api.pixwith.ai - uploads.pixwith.ai - "*.amazonaws.com"

filesystem: access: user-provided description: > May read image files explicitly provided by the user for image-to-video tasks.

persistence: modify_agent_config: false write_files: false

capabilities: - check_credits - text_to_video - image_to_video - image_upload - task_creation - task_status_polling

Pixwith Veo 3.1 — AI Video Generation

Generate videos through Pixwith using its Veo 3.1 integration. Supports text-to-video and image-to-video with start and end frames.

⚠️ CRITICAL — Do NOT Alter API Response Values

ALL values returned by the API (task_id, result_urls, image_url, upload_url, fields) are opaque tokens. Use them EXACTLY as returned — do NOT add, remove, or change even a single character. Store each value in a shell variable and reuse it directly. A single wrong character in task_id or result_urls will cause errors or broken links.

Setup

This skill requires a PIXWITH_API_KEY environment variable.

If the variable is not set, guide the user through these steps:

1. Go to https://pixwith.ai/api and sign up / log in. 2. Click "Add" to create a new API key and copy it. 3. This skill requires a PIXWITH_API_KEY provided by the runtime environment or the hosting platform's secret manager

If the API key is missing or invalid, instruct the user to create or verify a Pixwith API key from the Pixwith dashboard and provide it through the runtime's standard secret or environment-variable mechanism.

Verify by running:

curl -s -X POST https://api.pixwith.ai/api/task/get_credits \
  -H "Content-Type: application/json" \
  -H "Api-Key: $PIXWITH_API_KEY"

A successful response looks like {"code":1,"data":{"credits":500}}.

Pricing

| Tier | Model ID | Credits per video | Description | |------|----------|-------------------|--------------------------------| | Fast | 2-11 | 50 | Quick generation, good quality | | Pro | 2-12 | 200 | HD quality with audio |

Always inform the user of the cost before creating a task. Default to Fast unless the user explicitly requests higher quality or audio.

Model Parameters

Workflow A — Text-to-Video

Use when the user provides only a text prompt and no images.

Step 1: Check credits

curl -s -X POST https://api.pixwith.ai/api/task/get_credits \
  -H "Content-Type: application/json" \
  -H "Api-Key: $PIXWITH_API_KEY"

Verify data.credits >= 50 (Fast) or >= 200 (Pro).

Step 2: Create task

curl -s -X POST https://api.pixwith.ai/api/task/create \
  -H "Content-Type: application/json" \
  -H "Api-Key: $PIXWITH_API_KEY" \
  -d '{
    "prompt": "",
    "model_id": "2-11",
    "options": {
      "prompt_optimization": true,
      "aspect_ratio": "16:9"
    }
  }'

Use "model_id": "2-12" for Pro tier.

Response contains data.task_id and data.estimated_time (seconds).

Step 3: Poll for results

Wait for estimated_time seconds, then poll:

curl -s -X POST https://api.pixwith.ai/api/task/get \
  -H "Content-Type: application/json" \
  -H "Api-Key: $PIXWITH_API_KEY" \
  -d '{"task_id": ""}'

Video generation typically takes 60–180 seconds. Present the EXACT result_urls to the user.

Workflow B — Image-to-Video

Use when the user provides one or two reference images (start frame, optional end frame).

Step 1: Upload local images (if needed)

If the user provides a local file path (not a public URL), upload it first.

Upload constraints:

1a. Get a presigned upload URL:

curl -s -X POST https://api.pixwith.ai/api/task/pre_url \
  -H "Content-Type: application/json" \
  -H "Api-Key: $PIXWITH_API_KEY" \
  -d '{"image_name": "frame.jpg", "content_type": "image/jpeg"}'

Set content_type based on the file extension:

Response:

1b. Upload the file using the presigned data:

curl -s -X POST "" \
  -F "key=" \
  -F "Content-Type=" \
  -F "x-amz-credential=" \
  -F "x-amz-algorithm=" \
  -F "x-amz-date=" \
  -F "x-amz-signature=" \
  -F "policy=" \
  -F "file=@/path/to/local/image.jpg"

Fill every field from the upload_url.fields object into the form. After upload, use data.image_url from step 1a as the image URL.

Repeat for a second image if the user wants to specify an end frame. If the user already has public image URLs (start with http), skip this step.

Step 2: Check credits

Same as Workflow A, Step 1.

Step 3: Create task with images

curl -s -X POST https://api.pixwith.ai/api/task/create \
  -H "Content-Type: application/json" \
  -H "Api-Key: $PIXWITH_API_KEY" \
  -d '{
    "prompt": "",
    "image_urls": ["", ""],
    "model_id": "2-11",
    "options": {
      "prompt_optimization": true,
      "aspect_ratio": "16:9"
    }
  }'

Step 4: Poll for results

Same as Workflow A, Step 3.

Choosing Between Fast and Pro

| Aspect | Fast (2-11) | Pro (2-12) | |---------------|-----------------------|-----------------------------| | Cost | 50 credits | 200 credits | | Quality | Good | HD | | Audio | No | Yes, generated audio | | Speed | ~60 seconds | ~120 seconds | | Best for | Previews, prototyping | Final output, presentations |

Default to Fast unless the user requests:

Error Handling

All API responses follow {"code": 1, "message": "success", "data": {...}}. When code is 0, message contains the error. Common errors:

Defaults

When the user does not specify preferences, use these defaults:

This skill requires a PIXWITH_API_KEY environment variable.

If the variable is not set, guide the user through these steps:

1. Go to https://pixwith.ai/api and sign up / log in. 2. Click "Add" to create a new API key and copy it. 3. This skill requires a PIXWITH_API_KEY provided by the runtime environment or the hosting platform's secret manager

If the API key is missing or invalid, instruct the user to create or verify a Pixwith API key from the Pixwith dashboard and provide it through the runtime's standard secret or environment-variable mechanism.

Verify by running:

curl -s -X POST https://api.pixwith.ai/api/task/get_credits \
  -H "Content-Type: application/json" \
  -H "Api-Key: $PIXWITH_API_KEY"

A successful response looks like {"code":1,"data":{"credits":500}}.