Skip to content

Conversation

@maerch
Copy link
Member

@maerch maerch commented Jan 23, 2026

Summary

  • Use async delivery with polling for Runware image generation to avoid timeouts
  • Fix API errors caused by incorrect dimensions for NanoBanana2Pro and Seedream4 providers

Changes

Async API Delivery

  • Switch to deliveryMethod: "async" with polling for image generation
  • Prevents timeouts on slower models

Dimension Fixes

  • NanoBanana2Pro: Add model-specific dimension map (e.g., 16:9 requires 1376×768, not 1344×768)
  • NanoBanana2Pro I2I: Add resolution: '2k' parameter for auto aspect ratio detection
  • Seedream 4.0: Use 2K dimensions since 1K only supports 1:1 aspect ratio

Documentation

  • Add warning in api-patterns.md about model-specific dimensions
  • Add detailed dimension tables in implementation-notes.md
  • Add changelog entries

Test plan

  • Test NanoBanana2Pro with all aspect ratios (1:1, 16:9, 9:16, 4:3, 3:4)
  • Test Seedream 4.0 with all aspect ratios
  • Verify image-to-image generation works with reference images
  • Verify async polling works without timeouts

Switch from synchronous requests to async delivery method to avoid
timeouts on slower image generation models. The client now submits
tasks with deliveryMethod: "async" and polls for results using the
getResponse task type.
…edream4

NanoBanana2Pro and Seedream4 have specific dimension requirements that
don't match the generic ASPECT_RATIO_MAP. Using incorrect dimensions
(e.g., 1344x768 for 16:9) caused API errors.

- NanoBanana2Pro: Add custom dimension map with API-required values
  (e.g., 16:9 is 1376x768, not 1344x768)
- NanoBanana2Pro I2I: Add resolution parameter for auto aspect detection
- Seedream4: Use 2K dimensions since 1K only supports 1:1 aspect ratio
Add documentation for models that require specific dimension combinations
instead of the generic ASPECT_RATIO_MAP values:

- api-patterns.md: Add warning about model-specific dimensions
- implementation-notes.md: Add dimension tables for NanoBanana2Pro,
  Seedream 4.0, and Seedream 4.5
@vercel
Copy link

vercel bot commented Jan 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
eachlabs-demo Ready Ready Preview, Comment Jan 23, 2026 3:34pm
plugins-bytedance Ready Ready Preview, Comment Jan 23, 2026 3:34pm
plugins-web Ready Ready Preview, Comment Jan 23, 2026 3:34pm
runware-demo Ready Ready Preview, Comment Jan 23, 2026 3:34pm

Request Review

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.

1 participant