Skip to main content

veida

Generate images from Python with no API key, no account and no card.

from veida import generate

url = generate("a paper boat on a calm lake at sunrise, soft light", aspect_ratio="16:9")
print(url)   # https://cdn.veida.ai/uploads/kie/image/....webp

From the shell:

pip install veida
python -m veida "an isometric illustration of a small coffee shop, pastel palette" --ratio 16:9

Every other image library wants a key from OpenAI, fal or Replicate before it runs once. This one talks to the anonymous tier of Veida — a client id the library invents rather than an account you register — so it works on a fresh machine.

What you get

  • Zero dependencies. Standard library only, so there is nothing to pin and nothing that can drift out from under you.
  • A url, not bytes. The returned CDN link is permanent and cacheable, so it drops straight into a template, a Slack message or a database row.
  • Readable failures. VeidaError carries a sentence about what to do — quota spent, content filter, timeout — instead of a stack trace you have to interpret.

Limits, read out of the running service

  • The anonymous grant is 4 credits and one image costs 4, so the library mints a fresh caller per call. A loop is not limited to one image.
  • A ceiling of 30 credits per IP per day sits on top: roughly 7 images a day from one machine. When it is spent you get a VeidaError saying so.
  • Free output is 1K and watermarked.
  • 🔴 Editing an existing image is not available anonymously. The editing model costs 30 credits against a 4-credit grant, so an anonymous edit can never be paid for — this library does not pretend to offer one. Sign in and use the image editor or the ChatGPT image editor.
  • There is no video on this service.

Signing in removes the watermark, lifts the cap and opens the rest of the shelf — GPT Image 2 when the picture must contain readable text, Nano Banana 2 for instruction following, Seedream 5.0 Lite for colour and composition, Qwen Image 3 for typography. What each tier costs is on the pricing page.

Writing prompts that work

Name the light, the material and the composition. "A product photo of a mug" gives the model nothing; "matte black ceramic mug on pale oak, soft window light from the left, shallow depth of field" gives it a picture. Worked examples live in the prompt library, and finished output in the showcase.

The same engine backs the ChatGPT image generator and the free AI image generator in a browser. There is also an MCP server if you want the same thing inside an agent.

API

generate(prompt, aspect_ratio="1:1", timeout=240.0, poll_every=4.0) -> str

aspect_ratio is one of 1:1, 16:9, 9:16, 4:3, 3:4. Raises VeidaError.

MIT.

Metadata

Release files for veida 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for veida 0.1.0
File Size Uploaded Provenance
veida-0.1.0.tar.gz 5.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for veida 0.1.0
File Interpreter ABI Platform
veida-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 12.7 kB

Release files / veida-0.1.0.tar.gz

Download URL veida-0.1.0.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f9c2d04e0fe75fef5bd056009d5e71bfb7e8cf11de67982fb6a50febf1e9c516
BLAKE2b-256 checksum
How to use checksums
6c5a8dcd0cc9b644ddff02ddb36979a22966e36c708f1f114571ab00a12f7a7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / veida-0.1.0-py3-none-any.whl

Download URL veida-0.1.0-py3-none-any.whl
Size 6.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
243b8da8f9b5a7064057488f0cdd747df9d70ea225e0fa060fc3b83cea0e264e
BLAKE2b-256 checksum
How to use checksums
df9587f96ec53fe9a4ff4f20ac72335fa62399cf35c297b54c2222711e48f13f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Security for veida 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page