Skip to content

readme: rewrite with full v2 usage docs - #31

Draft
prodiapcode wants to merge 2 commits into
masterfrom
docs/improve-readme
Draft

prodiapcode wants to merge 2 commits into
masterfrom
docs/improve-readme

Conversation

@prodiapcode

Copy link
Copy Markdown
Contributor

What

Rewrites the readme to actually document what the SDK can do. The old readme had a single txt2img example and stopped there.

New sections:

  • Quickstart — txt2img with a pointer to the Model Explorer for discovering job types
  • Client ConfigurationbaseUrl, maxErrors, maxRetries with defaults
  • Reading OutputsarrayBuffer() / uint8Array() / formData()
  • Output Formats — the accept option
  • Image Inputs — the inputs option (img2img example, mirrors the docs.prodia.com guide)
  • Video Generation
  • Error HandlingProdiaUserError / ProdiaCapacityError / ProdiaBadResponseError and the built-in retry behavior
  • Development — the fmt/check/test commands CI runs

Also drops the stale "as of October 2024, v2 requires Pro+" note and keeps the v1 legacy section (marked deprecated).

Notes

  • All examples match the actual v2/index.ts API surface and use job types from the existing tests and docs.prodia.com guides (inference.flux.dev.txt2img.v1, inference.flux-2.klein.img2img.v1, inference.veo.fast.txt2vid.v1).
  • deno fmt --check readme.md passes.

🤖 Generated with Claude Code

claude and others added 2 commits August 31, 2026 16:28
Cover client configuration, output reading, output formats, image
inputs, video generation, and typed error handling. Drop the stale
October 2024 subscription note.

Co-Authored-By: Monty Anderson <work@montyanderson.net>
Logo mark + wordmark taken from the current brand assets in
prodia-mvp/v2-docs, with a prefers-color-scheme style so it renders
black on light and white on dark GitHub themes.

Co-Authored-By: Monty Anderson <work@montyanderson.net>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants