agentCLAWHUBUnverified

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,...

OpenClaw

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.

Install and run

Setup complexity: low.

clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-gpt-image-2
  1. Install using `clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-gpt-image-2` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. 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 USD

1 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 -s

skill-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.
Github ReposUpdated 2d agoRank 70

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "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

Sponsored

Ads related to Poyo Gpt Image 2 and adjacent AI workflows.