TOOL API

gpt_image2_submit

Submit a GPT Image 2 job and return job_id immediately. Billed per image: n defaults to 1, only integers 1-4 are accepted. size defaults to 1024x1024. Pass auto or one of 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9. Canonical sizes, which submit returns as requested_size: 1:1=1024x1024, 3:2=1536x1024, 2:3=1024x1536, 4:3=1536x1152, 3:4=1152x1536, 16:9=1536x864, 9:16=864x1536, 21:9=1680x720. Other ratios, non-canonical pixels, and 2K/4K sizes error with no charge. 1x1 errors; write 1:1 for a square. Actual output pixels are the size returned by gpt_image2_result; requested_size is only the request. background is auto (default) or opaque (opaque is ignored on the OpenRouter path). Transparent backgrounds are not supported; transparent is rejected before a job is created and is not charged. Poll with gpt_image2_result.