spora-ai/spora-plugin-openai-image

OpenAI-compatible image generation for Spora agents.

Maintainers

Package info

github.com/spora-ai/spora-plugin-openai-image

Type:spora-plugin

pkg:composer/spora-ai/spora-plugin-openai-image

Transparency log

Statistics

Installs: 124

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.2.0 2026-08-07 22:31 UTC

Requires

Requires (Dev)

MIT 491494ed840fda03058963e1f87ee1b948eb9e0b

Published on Packagist.org on 2026-08-09 13:14 UTC

This package is auto-updated.

Last update: 2026-08-12 10:01:00 UTC

README

This plugin provides the image_openai tool using the OpenAI Image API contract. Configure api_key, base_url, and model per agent so compatible providers can be used without code changes.

Generated base64 images are ingested into Spora's Media Archive when available. If the archive is unavailable or ingestion fails, the tool returns a data URL fallback.

The tool exposes two operations:

  • generate — single image from a text prompt. Calls POST {base_url}/images/generations. The expected response shape is data[].b64_json.

  • generate_variations — multiple images (default 3, max 8), or semantic variations of an existing image. Approval-gated by default.

    • Prompt-based (default): POST {base_url}/images/generations with n independent samples from the same prompt.
    • Image-based (input_image supplied): POST {base_url}/images/variations (multipart upload). input_image accepts an http(s) URL, a data: URI, a 36-char Media Archive UUID, or an opaque /api/v1/assets/<uuid>.<ext> URL. The plugin resolves Media Archive references server-side so the bytes never enter the chat context.