firered-image-edit

Edit images from text prompts using the FireRed Image Edit API via Pixazo.

Updated May 2, 2026
One-click install
npx skills add https://github.com/Pixazo-AI/skills --skill firered-image-edit-pixazo-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: firered-image-edit
Source: https://github.com/Pixazo-AI/skills/tree/main/skills/firered-image-edit
Command: npx skills add https://github.com/Pixazo-AI/skills --skill firered-image-edit-pixazo-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing images with natural language instructions normally requires manual work in image editors or complex model setup. This Skill lets an AI agent call the FireRed Image Edit API through the Pixazo gateway to apply prompt-driven edits to an existing image and return the result URL. ## Core Features & Use Cases - Prompt-based image editing: Send a source image URL plus a text instruction (e.g., change clothing color) and receive the edited image synchronously. - Version routing: Choose between FireRed Image Edit 1 and 1.1 endpoints based on the requested model version. - Built-in API key handling and error mapping: Guides the agent through Pixazo API key setup and translates 401/402/429/5xx responses into actionable user messages. - Use Case: A user uploads a product photo and asks to change the background or restyle an element; the agent builds the request, calls the endpoint, and returns the edited image URL inline. ## Quick Start Ask the agent to edit an image with FireRed Image Edit, for example: change the dress in this photo to black using the image at this URL.

Frequently Asked Questions about firered-image-edit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit an image with a text prompt using an API?▼

Send a POST request to the FireRed Image Edit endpoint with your prompt and the source image URL in the JSON body. The API processes the edit synchronously and returns a JSON response containing the edited image URL.

What is the difference between FireRed Image Edit 1 and 1.1?▼

Both versions perform image-to-image editing but use different endpoints and operation IDs: firered-image-edit for version 1 and firered-image-edit-v1-1 for version 1.1. Check the full reference at pixazo.ai/models/firered-image-edit.md for per-version parameter differences.

Do I need an API key to use FireRed Image Edit?▼

Yes, a Pixazo API key is required and passed via the Ocp-Apim-Subscription-Key header. You can create a free key at api-console.pixazo.ai/api_keys and store it in the PIXAZO_API_KEY environment variable or ~/.pixazo/api-key file.

Can I pass a local image file to the FireRed Image Edit API?▼

The API accepts images as a URL or a base64 data URL in the image field of the request body. Local files must be hosted somewhere accessible or converted to a base64 data URL before sending.

Why am I getting a 401 or 402 error from the Pixazo API?▼

A 401 means the API key is missing or invalid, so generate a fresh key at the Pixazo console. A 402 means your account is out of credits and needs a top-up at the Pixazo dashboard.