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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

veida-0.1.0.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

veida-0.1.0-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file veida-0.1.0.tar.gz.

File metadata

  • Download URL: veida-0.1.0.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for veida-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f9c2d04e0fe75fef5bd056009d5e71bfb7e8cf11de67982fb6a50febf1e9c516
MD5 7986fcd66b8e071b7d46298a12104096
BLAKE2b-256 6c5a8dcd0cc9b644ddff02ddb36979a22966e36c708f1f114571ab00a12f7a7f

See more details on using hashes here.

File details

Details for the file veida-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: veida-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for veida-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 243b8da8f9b5a7064057488f0cdd747df9d70ea225e0fa060fc3b83cea0e264e
MD5 a89b2f4e0f47bd271a534bd70f32ada8
BLAKE2b-256 df9587f96ec53fe9a4ff4f20ac72335fa62399cf35c297b54c2222711e48f13f

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

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