Model API

Phota

Phota's model empowers developers, photographers, and creators with personalized photograph generation and editing.

Model id

Use this in every request

phota

This model has other modes with their own ids: phota/edit.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "phota",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "phota", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for phota
Name	Type	Description
`prompt`required	string	Text description of the desired image. In case you wish to use specific profiles, refer to them as [[profile_id_1]], [[profile_id_2]], etc.
`num_images`	integer	Number of images to generate. Default: `1`
`output_format`	string (enum)	The format of the generated image. Default: `jpeg` One of: `jpeg`, `png`
`sync_mode`	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history. Default: `false`
`resolution`	string (enum)	Resolution of the generated image. Default: `1K` One of: `1K`, `4K`
`aspect_ratio`	string (enum)	Aspect ratio of the generated image. Default: `auto` One of: `auto`, `1:1`, `16:9`, `4:3`, `3:4`, `9:16`
`base_model`	string (enum)	Base model used to render the image. Identity composes on top of whichever base model is selected, so trained profiles work with all of them. Only `nb2` supports `4K`. Default: `nb2` One of: `nb2`, `qwen-image-2`, `flux-2`, `seedream-5-pro`

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt

"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

1K$0.15/ image
4K$0.29/ image

The exact charge for your input comes from a quote. How charges settle