Poyo Gpt Image 2
GPT Image 2 generation and editing on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `gpt-image-2`, `gpt-image-2-edit`, text-to-image,...
Rank
62
Safety
84
Downloads
999
Updated
Oct 11, 2026
Version
1.0.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 999 downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 999 downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.1release · observed Jul 6, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 1.0.1release
Strengthen PoYo links
Observed Jul 6, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-gpt-image-2- Install using `clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-gpt-image-2` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/coolhackboy/poyo-gpt-image-2 before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
22,295 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: poyo-gpt-image-2
description: GPT Image 2 generation and editing on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `gpt-image-2`, `gpt-image-2-edit`, text-to-image, multi-image editing with `image_urls`, single-image output, `auto` or aspect-ratio sizes, custom `WIDTHxHEIGHT`, and 1K/2K/4K resolution control.
metadata: {"openclaw":{"homepage":"https://poyo.ai/models/gpt-image-2","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}
---
# PoYo GPT Image 2 Generation and Editing
## PoYo Links
- Model page: <https://poyo.ai/models/gpt-image-2>
- API docs: <https://docs.poyo.ai/api-manual/image-series/gpt-image-2>
- API key page: <https://poyo.ai/dashboard/api-key>
Use this skill for GPT Image 2 jobs on PoYo. It covers text-to-image generation, reference-image-guided generation, and multi-image editing payloads for `gpt-image-2` and `gpt-image-2-edit`.
## Use When
- The user explicitly mentions `GPT Image 2`, `gpt-image-2`, or `gpt-image-2-edit`.
- The task is text-to-image, image-to-image, or editing one or more supplied images.
- The workflow needs broader aspect-ratio support, custom pixel size, or `1K` / `2K` / `4K` resolution control.
## Model Selection
- `gpt-image-2`: text-to-image generation and optional reference-image-guided generation.
- `gpt-image-2-edit`: editing based on one or more reference images and a text instruction; requires `image_urls`.
## Key Inputs
- `prompt` is required inside `input` and is limited to 4000 characters.
- `image_urls` is required for `gpt-image-2-edit` and supports multiple input images.
- Each request returns a single image.
- `size` supports `auto`, `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `4:5`, `5:4`, `16:9`, `9:16`, `21:9`, or custom `WIDTHxHEIGHT`.
- `resolution` supports `1K`, `2K`, and `4K`.
- Custom `WIDTHxHEIGHT` sizes require `resolution` to be `2K` or `4K`.
- `auto` size or omitted `size` always uses `1K` resolution.
## Execution
- Read `references/api.md` for endpoint details, model ids, key fields, example payloads, resolution notes, and polling notes.
- Use `scripts/submit_gpt_image_2.sh` to submit a raw JSON payload from the shell.
- If the user only needs a curl example, adapt one from `references/api.md` instead of rewriting from scratch.
- After submission, report the `task_id` clearly so follow-up polling is easy.
## Output Expectations
When helping with this model family, include:
- chosen model id
- whether the request is text-to-image, reference-guided generation, or editing
- final payload or a concise parameter summary
- selected `size` and `resolution`
- whether reference images are involved
- returned `task_id` if a request was actually submitted
- next step: poll status or wait for webhook_meta.json
{
"ownerId": "kn7f14qr8xdf5gs6pr7cm7p97h82m349",
"slug": "poyo-gpt-image-2",
"version": "1.0.1",
"publishedAt": 1783382133172
}references/api.md
# PoYo GPT Image 2 API Reference
## Endpoint
- Submit task: `https://api.poyo.ai/api/generate/submit`
- Status query: `GET https://api.poyo.ai/api/generate/status/{task_id}`
- Source docs: <https://docs.poyo.ai/api-manual/image-series/gpt-image-2>
- Model page: <https://poyo.ai/models/gpt-image-2>
- OpenAPI JSON: <https://docs.poyo.ai/api-manual/image-series/gpt-image-2.json>
## Auth
Send:
```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```
Get API keys from <https://poyo.ai/dashboard/api-key>.
Recommended skill env var:
- `POYO_API_KEY`
## Models
- `gpt-image-2` — text-to-image generation and optional reference-image-guided generation
- `gpt-image-2-edit` — image editing from one or more reference images; requires `image_urls`
## Key input fields
- `model` (string, required) — choose `gpt-image-2` or `gpt-image-2-edit`
- `callback_url` (string, optional) — Webhook callback URL for result notifications
- `input.prompt` (string, required, max 4000 chars) — Prompt describing the target image or requested edit
- `input.image_urls` (string[], optional) — Reference image URLs; required for `gpt-image-2-edit`; supports multiple input images
- `input.size` (string, optional, default `auto`) — Output aspect ratio or custom pixel size
- `input.resolution` (string, optional, default `1K`) — Output resolution: `1K`, `2K`, or `4K`
## Size and resolution
Preset `size` values:
- `auto`
- `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `4:5`, `5:4`
- `16:9`, `9:16`, `21:9`
Custom size:
- Use `WIDTHxHEIGHT`, for example `2304x1536`.
- Custom size requires `resolution` to be `2K` or `4K`.
- `auto` size or omitted `size` always uses `1K` resolution.
- Use documented `4K` settings only for supported aspect ratios or custom sizes; verify current output behavior in the PoYo docs before relying on it.
## Important constraints
- `gpt-image-2-edit` requires `image_urls`.
- Each request returns a single image.
- Public image URLs must be directly downloadable by the upstream provider.
## Text-to-image example
```bash
curl -sS https://api.poyo.ai/api/generate/submit \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-image-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail",
"size": "1:1"
}
}'
```
## 2K generation example
```bash
curl -sS https://api.poyo.ai/api/generate/submit \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-image-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail",
"size": "16:9",
"resolution": "2K"
}
}'
```
## 4K generation example
```bash
curl -sskill-card.md
## Description: Helps agents prepare and submit PoYo GPT Image 2 generation and editing requests, including model choice, payload fields, curl submission, and polling guidance. This skill is ready for commercial/non-commercial use. ## Publisher: [coolhackboy](https://clawhub.ai/user/coolhackboy) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agents use this skill to create text-to-image, reference-guided, or multi-image editing requests for PoYo GPT Image 2. It helps select `gpt-image-2` or `gpt-image-2-edit`, form payloads, submit jobs, and track the returned task ID. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Image-generation prompts and referenced image URLs are sent to PoYo. Mitigation: Install and use the skill only when sending that content to PoYo is intended; avoid private, internal, signed, or sensitive image URLs unless external access is acceptable. Risk: API keys can be exposed if passed directly on the command line or stored in shared payloads. Mitigation: Set `POYO_API_KEY` in the environment and keep credentials out of prompts, payload files, shell history, and shared logs. ## Reference(s): - [PoYo GPT Image 2 API Reference](references/api.md) - [PoYo GPT Image 2 model page](https://poyo.ai/models/gpt-image-2) - [PoYo GPT Image 2 API docs](https://docs.poyo.ai/api-manual/image-series/gpt-image-2) - [PoYo GPT Image 2 OpenAPI JSON](https://docs.poyo.ai/api-manual/image-series/gpt-image-2.json) - [ClawHub skill page](https://clawhub.ai/coolhackboy/skills/poyo-gpt-image-2) - [Publisher profile](https://clawhub.ai/user/coolhackboy) ## Skill Output: **Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance] **Output Format:** [Markdown with JSON payloads and inline shell commands] **Output Parameters:** [1D] **Other Properties Related to Output:** [May include selected model ID, request mode, size, resolution, reference-image use, returned task ID, and polling or webhook next steps.] ## Skill Version(s): 1.0.1 (source: server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/coolhackboy/skills/poyo-gpt-image-2",
"sourceUrl": "https://clawhub.ai/coolhackboy/skills/poyo-gpt-image-2",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T20:09:04.116Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T20:09:04.116Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "999 downloads",
"href": "https://clawhub.ai/coolhackboy/poyo-gpt-image-2",
"sourceUrl": "https://clawhub.ai/coolhackboy/poyo-gpt-image-2",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T20:09:04.116Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.1",
"href": "https://clawhub.ai/coolhackboy/poyo-gpt-image-2",
"sourceUrl": "https://clawhub.ai/coolhackboy/poyo-gpt-image-2",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-06T23:55:33.172Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.1",
"description": "Strengthen PoYo links",
"href": "https://clawhub.ai/coolhackboy/poyo-gpt-image-2",
"sourceUrl": "https://clawhub.ai/coolhackboy/poyo-gpt-image-2",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-06T23:55:33.172Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/run-check
