{"id":"d8c5c85c-372d-414f-88fc-b0c867b25d4a","entityType":"agent","slug":"clawhub-coolhackboy-poyo-gpt-image-2","name":"Poyo Gpt Image 2","canonicalUrl":"https://www.xpersona.co/agent/clawhub-coolhackboy-poyo-gpt-image-2","canonicalPath":"/agent/clawhub-coolhackboy-poyo-gpt-image-2","generatedAt":"2026-10-12T08:58:16.372Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:09:04.116Z","emptyReason":null},"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,...","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 999 downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-gpt-image-2","sourceUrl":"https://clawhub.ai/coolhackboy/poyo-gpt-image-2","homepage":"https://clawhub.ai/coolhackboy/skills/poyo-gpt-image-2","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/coolhackboy/poyo-gpt-image-2","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/coolhackboy/skills/poyo-gpt-image-2","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Poyo Gpt Image 2 technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:09:04.116Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:09:04.116Z","emptyReason":null},"stars":null,"forks":null,"downloads":999,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.0.1","tractionLabel":"999 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:09:04.044Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T20:09:04.116Z","lastCrawledAt":"2026-10-11T20:09:04.044Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T20:09:04.045Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.1","createdAt":"2026-07-06T23:55:33.172Z","changelog":"Strengthen PoYo links","fileCount":5,"zipByteSize":5155},{"version":"1.0.0","createdAt":"2026-04-25T11:33:15.094Z","changelog":"- Initial release of PoYo GPT Image 2 generation and editing skill. - Supports text-to-image and multi-image editing using PoYo’s GPT Image 2 via API. - Allows broad aspect-ratio and custom pixel size selection, with control over 1K, 2K, and 4K resolutions. - Includes detailed model selection for `gpt-image-2` and `gpt-image-2-edit` tasks. - Provides concise output expectations and clear workflow guidance for job submissions and follow-ups.","fileCount":5,"zipByteSize":5143}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-gpt-image-2","setupComplexity":"low","setupSteps":["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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-12T08:58:16.372Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-gpt-image-2/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:09:04.116Z","emptyReason":null},"readme":"Skill: Poyo Gpt Image 2\n\nOwner: coolhackboy\n\nSummary: 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,...\n\nTags: latest:1.0.1\n\nVersion history:\n\nv1.0.1 | 2026-07-06T23:55:33.172Z | user\n\nStrengthen PoYo links\n\nv1.0.0 | 2026-04-25T11:33:15.094Z | user\n\n- Initial release of PoYo GPT Image 2 generation and editing skill.\n- Supports text-to-image and multi-image editing using PoYo’s GPT Image 2 via API.\n- Allows broad aspect-ratio and custom pixel size selection, with control over 1K, 2K, and 4K resolutions.\n- Includes detailed model selection for `gpt-image-2` and `gpt-image-2-edit` tasks.\n- Provides concise output expectations and clear workflow guidance for job submissions and follow-ups.\n\nArchive index:\n\nArchive v1.0.1: 5 files, 5155 bytes\n\nFiles: references/api.md (5205b), scripts/submit_gpt_image_2.sh (605b), skill-card.md (2352b), SKILL.md (2772b), _meta.json (135b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: poyo-gpt-image-2\ndescription: 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.\nmetadata: {\"openclaw\":{\"homepage\":\"https://poyo.ai/models/gpt-image-2\",\"requires\":{\"bins\":[\"curl\"],\"env\":[\"POYO_API_KEY\"]},\"primaryEnv\":\"POYO_API_KEY\"}}\n---\n\n# PoYo GPT Image 2 Generation and Editing\n\n## PoYo Links\n\n- Model page: \n- API docs: \n- API key page: \n\nUse 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`.\n\n## Use When\n\n- The user explicitly mentions `GPT Image 2`, `gpt-image-2`, or `gpt-image-2-edit`.\n- The task is text-to-image, image-to-image, or editing one or more supplied images.\n- The workflow needs broader aspect-ratio support, custom pixel size, or `1K` / `2K` / `4K` resolution control.\n\n## Model Selection\n\n- `gpt-image-2`: text-to-image generation and optional reference-image-guided generation.\n- `gpt-image-2-edit`: editing based on one or more reference images and a text instruction; requires `image_urls`.\n\n## Key Inputs\n\n- `prompt` is required inside `input` and is limited to 4000 characters.\n- `image_urls` is required for `gpt-image-2-edit` and supports multiple input images.\n- Each request returns a single image.\n- `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`.\n- `resolution` supports `1K`, `2K`, and `4K`.\n- Custom `WIDTHxHEIGHT` sizes require `resolution` to be `2K` or `4K`.\n- `auto` size or omitted `size` always uses `1K` resolution.\n\n## Execution\n\n- Read `references/api.md` for endpoint details, model ids, key fields, example payloads, resolution notes, and polling notes.\n- Use `scripts/submit_gpt_image_2.sh` to submit a raw JSON payload from the shell.\n- If the user only needs a curl example, adapt one from `references/api.md` instead of rewriting from scratch.\n- After submission, report the `task_id` clearly so follow-up polling is easy.\n\n## Output Expectations\n\nWhen helping with this model family, include:\n- chosen model id\n- whether the request is text-to-image, reference-guided generation, or editing\n- final payload or a concise parameter summary\n- selected `size` and `resolution`\n- whether reference images are involved\n- returned `task_id` if a request was actually submitted\n- next step: poll status or wait for webhook\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn7f14qr8xdf5gs6pr7cm7p97h82m349\",\n \"slug\": \"poyo-gpt-image-2\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1783382133172\n}\n\nFile v1.0.1:references/api.md\n\n# PoYo GPT Image 2 API Reference\n\n## Endpoint\n\n- Submit task: `https://api.poyo.ai/api/generate/submit`\n- Status query: `GET https://api.poyo.ai/api/generate/status/{task_id}`\n- Source docs: \n- Model page: \n- OpenAPI JSON: \n\n## Auth\n\nSend:\n\n```http\nAuthorization: Bearer YOUR_API_KEY\nContent-Type: application/json\n```\n\nGet API keys from .\n\nRecommended skill env var:\n\n- `POYO_API_KEY`\n\n## Models\n\n- `gpt-image-2` — text-to-image generation and optional reference-image-guided generation\n- `gpt-image-2-edit` — image editing from one or more reference images; requires `image_urls`\n\n## Key input fields\n\n- `model` (string, required) — choose `gpt-image-2` or `gpt-image-2-edit`\n- `callback_url` (string, optional) — Webhook callback URL for result notifications\n- `input.prompt` (string, required, max 4000 chars) — Prompt describing the target image or requested edit\n- `input.image_urls` (string[], optional) — Reference image URLs; required for `gpt-image-2-edit`; supports multiple input images\n- `input.size` (string, optional, default `auto`) — Output aspect ratio or custom pixel size\n- `input.resolution` (string, optional, default `1K`) — Output resolution: `1K`, `2K`, or `4K`\n\n## Size and resolution\n\nPreset `size` values:\n\n- `auto`\n- `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `4:5`, `5:4`\n- `16:9`, `9:16`, `21:9`\n\nCustom size:\n\n- Use `WIDTHxHEIGHT`, for example `2304x1536`.\n- Custom size requires `resolution` to be `2K` or `4K`.\n- `auto` size or omitted `size` always uses `1K` resolution.\n- Use documented `4K` settings only for supported aspect ratios or custom sizes; verify current output behavior in the PoYo docs before relying on it.\n\n## Important constraints\n\n- `gpt-image-2-edit` requires `image_urls`.\n- Each request returns a single image.\n- Public image URLs must be directly downloadable by the upstream provider.\n\n## Text-to-image example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail\",\n \"size\": \"1:1\"\n }\n }'\n```\n\n## 2K generation example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail\",\n \"size\": \"16:9\",\n \"resolution\": \"2K\"\n }\n }'\n```\n\n## 4K generation example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A cinematic landscape with dramatic lighting, ultra-high detail\",\n \"size\": \"16:9\",\n \"resolution\": \"4K\"\n }\n }'\n```\n\n## Custom size example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background\",\n \"size\": \"2304x1536\",\n \"resolution\": \"2K\"\n }\n }'\n```\n\n## Edit example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2-edit\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"Use these reference images together to create a polished product photo: keep the flower subject, use the vase shape from the second image, replace the background with a clean white studio backdrop, and add a soft natural shadow\",\n \"image_urls\": [\n \"https://example.com/flower.jpg\",\n \"https://example.com/vase.jpg\"\n ],\n \"size\": \"1:1\"\n }\n }'\n```\n\n## Polling notes\n\n- PoYo returns a `task_id` after submission.\n- If `callback_url` is present, PoYo sends a POST callback when the task reaches `finished` or `failed`.\n- Whether or not callbacks are used, save the returned `task_id` and query the standard status endpoint when polling is needed.\n\n## Practical guidance\n\n- Use `gpt-image-2` for pure prompt generation; add `image_urls` only when reference-guided generation is needed.\n- Use `gpt-image-2-edit` when the prompt asks to modify supplied images.\n- Choose `auto` or omit `size` for default 1K output; specify `resolution` when the user needs 2K or 4K.\n- Save the returned `task_id` immediately so status polling is straightforward.\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\nHelps agents prepare and submit PoYo GPT Image 2 generation and editing requests, including model choice, payload fields, curl submission, and polling guidance.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[coolhackboy](https://clawhub.ai/user/coolhackboy)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Image-generation prompts and referenced image URLs are sent to PoYo.\n\nMitigation: 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.\n\nRisk: API keys can be exposed if passed directly on the command line or stored in shared payloads.\n\nMitigation: Set `POYO_API_KEY` in the environment and keep credentials out of prompts, payload files, shell history, and shared logs.\n\n## Reference(s):\n\n- [PoYo GPT Image 2 API Reference](references/api.md)\n- [PoYo GPT Image 2 model page](https://poyo.ai/models/gpt-image-2)\n- [PoYo GPT Image 2 API docs](https://docs.poyo.ai/api-manual/image-series/gpt-image-2)\n- [PoYo GPT Image 2 OpenAPI JSON](https://docs.poyo.ai/api-manual/image-series/gpt-image-2.json)\n- [ClawHub skill page](https://clawhub.ai/coolhackboy/skills/poyo-gpt-image-2)\n- [Publisher profile](https://clawhub.ai/user/coolhackboy)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with JSON payloads and inline shell commands]\n\n**Output Parameters:** [1D]\n\n**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.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.0.0: 5 files, 5143 bytes\n\nFiles: references/api.md (5205b), scripts/submit_gpt_image_2.sh (605b), skill-card.md (2542b), SKILL.md (2604b), _meta.json (135b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: poyo-gpt-image-2\ndescription: 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.\nmetadata: {\"openclaw\":{\"homepage\":\"https://docs.poyo.ai/api-manual/image-series/gpt-image-2\",\"requires\":{\"bins\":[\"curl\"],\"env\":[\"POYO_API_KEY\"]},\"primaryEnv\":\"POYO_API_KEY\"}}\n---\n\n# PoYo GPT Image 2 Generation and Editing\n\nUse 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`.\n\n## Use When\n\n- The user explicitly mentions `GPT Image 2`, `gpt-image-2`, or `gpt-image-2-edit`.\n- The task is text-to-image, image-to-image, or editing one or more supplied images.\n- The workflow needs broader aspect-ratio support, custom pixel size, or `1K` / `2K` / `4K` resolution control.\n\n## Model Selection\n\n- `gpt-image-2`: text-to-image generation and optional reference-image-guided generation.\n- `gpt-image-2-edit`: editing based on one or more reference images and a text instruction; requires `image_urls`.\n\n## Key Inputs\n\n- `prompt` is required inside `input` and is limited to 4000 characters.\n- `image_urls` is required for `gpt-image-2-edit` and supports multiple input images.\n- Each request returns a single image.\n- `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`.\n- `resolution` supports `1K`, `2K`, and `4K`.\n- Custom `WIDTHxHEIGHT` sizes require `resolution` to be `2K` or `4K`.\n- `auto` size or omitted `size` always uses `1K` resolution.\n\n## Execution\n\n- Read `references/api.md` for endpoint details, model ids, key fields, example payloads, resolution notes, and polling notes.\n- Use `scripts/submit_gpt_image_2.sh` to submit a raw JSON payload from the shell.\n- If the user only needs a curl example, adapt one from `references/api.md` instead of rewriting from scratch.\n- After submission, report the `task_id` clearly so follow-up polling is easy.\n\n## Output Expectations\n\nWhen helping with this model family, include:\n- chosen model id\n- whether the request is text-to-image, reference-guided generation, or editing\n- final payload or a concise parameter summary\n- selected `size` and `resolution`\n- whether reference images are involved\n- returned `task_id` if a request was actually submitted\n- next step: poll status or wait for webhook\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn7f14qr8xdf5gs6pr7cm7p97h82m349\",\n \"slug\": \"poyo-gpt-image-2\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1777116795094\n}\n\nFile v1.0.0:references/api.md\n\n# PoYo GPT Image 2 API Reference\n\n## Endpoint\n\n- Submit task: `https://api.poyo.ai/api/generate/submit`\n- Status query: \n- Source docs: \n- Model page: \n- OpenAPI JSON: \n\n## Auth\n\nSend:\n\n```http\nAuthorization: Bearer YOUR_API_KEY\nContent-Type: application/json\n```\n\nGet API keys from .\n\nRecommended skill env var:\n\n- `POYO_API_KEY`\n\n## Models\n\n- `gpt-image-2` — text-to-image generation and optional reference-image-guided generation\n- `gpt-image-2-edit` — image editing from one or more reference images; requires `image_urls`\n\n## Key input fields\n\n- `model` (string, required) — choose `gpt-image-2` or `gpt-image-2-edit`\n- `callback_url` (string, optional) — Webhook callback URL for result notifications\n- `input.prompt` (string, required, max 4000 chars) — Prompt describing the target image or requested edit\n- `input.image_urls` (string[], optional) — Reference image URLs; required for `gpt-image-2-edit`; supports multiple input images\n- `input.size` (string, optional, default `auto`) — Output aspect ratio or custom pixel size\n- `input.resolution` (string, optional, default `1K`) — Output resolution: `1K`, `2K`, or `4K`\n\n## Size and resolution\n\nPreset `size` values:\n\n- `auto`\n- `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `4:5`, `5:4`\n- `16:9`, `9:16`, `21:9`\n\nCustom size:\n\n- Use `WIDTHxHEIGHT`, for example `2304x1536`.\n- Custom size requires `resolution` to be `2K` or `4K`.\n- `auto` size or omitted `size` always uses `1K` resolution.\n- True `4K` billing applies only to `16:9`, `9:16`, `21:9`, or custom sizes with a 3840-pixel edge; other `4K` selections are billed as `2K`.\n\n## Important constraints\n\n- `gpt-image-2-edit` requires `image_urls`.\n- Each request returns a single image.\n- Public image URLs must be directly downloadable by the upstream provider.\n\n## Text-to-image example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail\",\n \"size\": \"1:1\"\n }\n }'\n```\n\n## 2K generation example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail\",\n \"size\": \"16:9\",\n \"resolution\": \"2K\"\n }\n }'\n```\n\n## 4K generation example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A cinematic landscape with dramatic lighting, ultra-high detail\",\n \"size\": \"16:9\",\n \"resolution\": \"4K\"\n }\n }'\n```\n\n## Custom size example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background\",\n \"size\": \"2304x1536\",\n \"resolution\": \"2K\"\n }\n }'\n```\n\n## Edit example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2-edit\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"Use these reference images together to create a polished product photo: keep the flower subject, use the vase shape from the second image, replace the background with a clean white studio backdrop, and add a soft natural shadow\",\n \"image_urls\": [\n \"https://example.com/flower.jpg\",\n \"https://example.com/vase.jpg\"\n ],\n \"size\": \"1:1\"\n }\n }'\n```\n\n## Polling notes\n\n- PoYo returns a `task_id` after submission.\n- If `callback_url` is present, PoYo sends a POST callback when the task reaches `finished` or `failed`.\n- Whether or not callbacks are used, the same unified task status docs apply: .\n\n## Practical guidance\n\n- Use `gpt-image-2` for pure prompt generation; add `image_urls` only when reference-guided generation is needed.\n- Use `gpt-image-2-edit` when the prompt asks to modify supplied images.\n- Choose `auto` or omit `size` for default 1K output; specify `resolution` when the user needs 2K or 4K.\n- Save the returned `task_id` immediately so status polling is straightforward.\n\nFile v1.0.0:skill-card.md\n\n## Description:
\nGPT 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.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[coolhackboy](https://clawhub.ai/user/coolhackboy)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers and agents use this skill to prepare and submit PoYo GPT Image 2 text-to-image, reference-guided generation, and image-editing requests with the correct model, payload fields, size, and resolution settings.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Prompts, referenced image URLs, job metadata, callbacks, and generated results are sent to PoYo and any configured callback endpoint.
\nMitigation: Avoid secrets, private internal URLs, confidential images, and proprietary prompts unless the user trusts PoYo and the callback receiver.
\nRisk: The skill requires a PoYo API key.
\nMitigation: Use the POYO_API_KEY environment variable, avoid placing credentials in prompts or committed files, and rotate the key if it is exposed.
\n\n\n## Reference(s):
\n- [PoYo GPT Image 2 API documentation](https://docs.poyo.ai/api-manual/image-series/gpt-image-2)
\n- [PoYo task status documentation](https://docs.poyo.ai/api-manual/task-management/status)
\n- [PoYo GPT Image 2 model page](https://poyo.ai/models/gpt-image-2)
\n- [PoYo GPT Image 2 OpenAPI JSON](https://docs.poyo.ai/api-manual/image-series/gpt-image-2.json)
\n- [Bundled API reference](references/api.md)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with JSON payloads and shell command examples]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May submit one PoYo image generation or edit job per API request and report a task_id for polling or callback follow-up.]
\n\n## Skill Version(s):
\n1.0.0 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
","readmeExcerpt":"Skill: Poyo Gpt Image 2 Owner: coolhackboy Summary: 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,... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-07-06T23:55:33.172Z | user Strengthen PoYo links v1.0.0 | 2026-04-25T11:33:15.094Z | user - Initial release of PoYo GPT Image 2 generation and editing skill. - Sup","codeSnippets":[],"executableExamples":[{"language":"http","snippet":"Authorization: Bearer YOUR_API_KEY\nContent-Type: application/json"},{"language":"bash","snippet":"curl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{"},{"language":"bash","snippet":"curl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail\",\n \"size\": \"1:1\"\n }\n }'"},{"language":"bash","snippet":"curl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{"},{"language":"bash","snippet":"curl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail\",\n \"size\": \"16:9\",\n \"resolution\": \"2K\"\n }\n }'"},{"language":"bash","snippet":"curl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: poyo-gpt-image-2\ndescription: 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.\nmetadata: {\"openclaw\":{\"homepage\":\"https://poyo.ai/models/gpt-image-2\",\"requires\":{\"bins\":[\"curl\"],\"env\":[\"POYO_API_KEY\"]},\"primaryEnv\":\"POYO_API_KEY\"}}\n---\n\n# PoYo GPT Image 2 Generation and Editing\n\n## PoYo Links\n\n- Model page: \n- API docs: \n- API key page: \n\nUse 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`.\n\n## Use When\n\n- The user explicitly mentions `GPT Image 2`, `gpt-image-2`, or `gpt-image-2-edit`.\n- The task is text-to-image, image-to-image, or editing one or more supplied images.\n- The workflow needs broader aspect-ratio support, custom pixel size, or `1K` / `2K` / `4K` resolution control.\n\n## Model Selection\n\n- `gpt-image-2`: text-to-image generation and optional reference-image-guided generation.\n- `gpt-image-2-edit`: editing based on one or more reference images and a text instruction; requires `image_urls`.\n\n## Key Inputs\n\n- `prompt` is required inside `input` and is limited to 4000 characters.\n- `image_urls` is required for `gpt-image-2-edit` and supports multiple input images.\n- Each request returns a single image.\n- `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`.\n- `resolution` supports `1K`, `2K`, and `4K`.\n- Custom `WIDTHxHEIGHT` sizes require `resolution` to be `2K` or `4K`.\n- `auto` size or omitted `size` always uses `1K` resolution.\n\n## Execution\n\n- Read `references/api.md` for endpoint details, model ids, key fields, example payloads, resolution notes, and polling notes.\n- Use `scripts/submit_gpt_image_2.sh` to submit a raw JSON payload from the shell.\n- If the user only needs a curl example, adapt one from `references/api.md` instead of rewriting from scratch.\n- After submission, report the `task_id` clearly so follow-up polling is easy.\n\n## Output Expectations\n\nWhen helping with this model family, include:\n- chosen model id\n- whether the request is text-to-image, reference-guided generation, or editing\n- final payload or a concise parameter summary\n- selected `size` and `resolution`\n- whether reference images are involved\n- returned `task_id` if a request was actually submitted\n- next step: poll status or wait for webhook"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7f14qr8xdf5gs6pr7cm7p97h82m349\",\n \"slug\": \"poyo-gpt-image-2\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1783382133172\n}"},{"path":"references/api.md","content":"# PoYo GPT Image 2 API Reference\n\n## Endpoint\n\n- Submit task: `https://api.poyo.ai/api/generate/submit`\n- Status query: `GET https://api.poyo.ai/api/generate/status/{task_id}`\n- Source docs: \n- Model page: \n- OpenAPI JSON: \n\n## Auth\n\nSend:\n\n```http\nAuthorization: Bearer YOUR_API_KEY\nContent-Type: application/json\n```\n\nGet API keys from .\n\nRecommended skill env var:\n\n- `POYO_API_KEY`\n\n## Models\n\n- `gpt-image-2` — text-to-image generation and optional reference-image-guided generation\n- `gpt-image-2-edit` — image editing from one or more reference images; requires `image_urls`\n\n## Key input fields\n\n- `model` (string, required) — choose `gpt-image-2` or `gpt-image-2-edit`\n- `callback_url` (string, optional) — Webhook callback URL for result notifications\n- `input.prompt` (string, required, max 4000 chars) — Prompt describing the target image or requested edit\n- `input.image_urls` (string[], optional) — Reference image URLs; required for `gpt-image-2-edit`; supports multiple input images\n- `input.size` (string, optional, default `auto`) — Output aspect ratio or custom pixel size\n- `input.resolution` (string, optional, default `1K`) — Output resolution: `1K`, `2K`, or `4K`\n\n## Size and resolution\n\nPreset `size` values:\n\n- `auto`\n- `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `4:5`, `5:4`\n- `16:9`, `9:16`, `21:9`\n\nCustom size:\n\n- Use `WIDTHxHEIGHT`, for example `2304x1536`.\n- Custom size requires `resolution` to be `2K` or `4K`.\n- `auto` size or omitted `size` always uses `1K` resolution.\n- Use documented `4K` settings only for supported aspect ratios or custom sizes; verify current output behavior in the PoYo docs before relying on it.\n\n## Important constraints\n\n- `gpt-image-2-edit` requires `image_urls`.\n- Each request returns a single image.\n- Public image URLs must be directly downloadable by the upstream provider.\n\n## Text-to-image example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail\",\n \"size\": \"1:1\"\n }\n }'\n```\n\n## 2K generation example\n\n```bash\ncurl -sS https://api.poyo.ai/api/generate/submit \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"model\": \"gpt-image-2\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail\",\n \"size\": \"16:9\",\n \"resolution\": \"2K\"\n }\n }'\n```\n\n## 4K generation example\n\n```bash\ncurl -s"},{"path":"skill-card.md","content":"## Description:\n\nHelps agents prepare and submit PoYo GPT Image 2 generation and editing requests, including model choice, payload fields, curl submission, and polling guidance.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[coolhackboy](https://clawhub.ai/user/coolhackboy)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Image-generation prompts and referenced image URLs are sent to PoYo.\n\nMitigation: 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.\n\nRisk: API keys can be exposed if passed directly on the command line or stored in shared payloads.\n\nMitigation: Set `POYO_API_KEY` in the environment and keep credentials out of prompts, payload files, shell history, and shared logs.\n\n## Reference(s):\n\n- [PoYo GPT Image 2 API Reference](references/api.md)\n- [PoYo GPT Image 2 model page](https://poyo.ai/models/gpt-image-2)\n- [PoYo GPT Image 2 API docs](https://docs.poyo.ai/api-manual/image-series/gpt-image-2)\n- [PoYo GPT Image 2 OpenAPI JSON](https://docs.poyo.ai/api-manual/image-series/gpt-image-2.json)\n- [ClawHub skill page](https://clawhub.ai/coolhackboy/skills/poyo-gpt-image-2)\n- [Publisher profile](https://clawhub.ai/user/coolhackboy)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with JSON payloads and inline shell commands]\n\n**Output Parameters:** [1D]\n\n**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.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1459,"uniquenessScore":38,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T20:09:04.116Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T20:09:04.116Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-12T08:58:16.372Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"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!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"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","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}