# Recraft V3 Text-to-Image (PaySponge x402)

> Recraft V3 Text-to-Image (PaySponge x402) is a paid API for AI agents from fal.x402.paysponge.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-11).

Submits a Recraft V3 text-to-image generation job via fal.ai, with brand-oriented rendering, long-text-in-image support, and optional color palette hints, paid via x402/USDC.

## Facts

- Endpoint: POST https://fal.x402.paysponge.com/fal-ai/recraft-v3?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/recraft-v3-text-to-image-paysponge-x402-27bb8d46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E-WWao52wKCEQN1KDE8Jw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability recraft-v3-text-to-image-paysponge-x402-27bb8d46 -d '<json body>'
```

Example prompt: Generate a realistic_image of a modern coffee shop interior with warm lighting and a cozy atmosphere using Recraft V3, in landscape_16_9 format, with a color palette of warm browns — RGB (101, 67, 33) and (205, 133, 63).

## When to prefer this

Choose Recraft V3 when you need brand-consistent image generation with precise color palette control, need to render readable long text within images, or require vector/digital illustration styles. Prefer it over FLUX or SDXL variants when brand fidelity and color accuracy matter more than raw photorealism or generation speed.

## Known failure modes

- Missing required 'prompt' field returns a 400 validation error
- Invalid style name not in Recraft's style catalog causes job failure or unexpected output
- Payment failure via x402 protocol blocks the request before queuing
- Invalid RGB color object (missing r/g/b keys) causes schema validation error
- Custom style_id that doesn't exist leads to a rendering error on fal.ai's side
- Polling status_url after job completes may return expired response if not fetched promptly

## How this service works

POST /fal-ai/recraft-v3

## Output

Returns a JSON object with a request_id, a status_url to poll for job completion, a response_url to retrieve the final image once done, a cancel_url to abort the job, and the current queue_position indicating how far back in line the job is.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "prompt"
 ],
 "properties": {
  "style": {
   "type": "string",
   "description": "Recraft style name. Supports `realistic_image`, `digital_illustration`, `vector_illustration`, and the larger style catalog documented by fal.ai."
  },
  "colors": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "b": {
      "type": "integer",
      "description": "Blue channel value."
     },
     "g": {
      "type": "integer",
      "description": "Green channel value."
     },
     "r": {
      "type": "integer",
      "description": "Red channel value."
     }
    },
    "additionalProperties": false
   },
   "description": "Optional preferred colors."
  },
  "prompt": {
   "type": "string",
   "description": "Text prompt describing the desired output. Be concrete: name the subject, style, composition, and any key attributes. Longer prompts (50–200 words) typically produce more faithful results."
  },
  "style_id": {
   "type": "string",
   "description": "Optional custom style reference ID."
  },
  "image_size": {
   "oneOf": [
    {
     "enum": [
      "square_hd",
      "square",
      "portrait_4_3",
      "portrait_16_9",
      "landscape_4_3",
      "landscape_16_9"
     ],
     "type": "string"
    },
    {
     "type": "object",
     "properties": {
      "width": {
       "type": "integer",
       "description": "Width in pixels."
      },
      "height": {
       "type": "integer",
       "description": "Height in pixels."
      }
     },
     "additionalProperties": false
    }
   ]
  },
  "enable_safety_checker": {
   "type": "boolean"
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "request_id",
  "response_url",
  "status_url",
  "cancel_url",
  "queue_position"
 ],
 "properties": {
  "cancel_url": {
   "type": "string",
   "format": "uri"
  },
  "request_id": {
   "type": "string"
  },
  "status_url": {
   "type": "string",
   "format": "uri"
  },
  "response_url": {
   "type": "string",
   "format": "uri"
  },
  "queue_position": {
   "type": "integer"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/recraft-v3-text-to-image-paysponge-x402-27bb8d46/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fal.x402.paysponge.com](https://www.zero.xyz/host/fal.x402.paysponge.com/llms.txt)