Skip to main content

Frequently Asked Questions

Account & Authentication​

How do I create an account?​

Visit app.napkin.ai and sign up for a free account. Once registered, you can access the API by creating an API token in your account settings.

How do I get an API token?​

  1. Log in to your account at app.napkin.ai
  2. Go to your Account Settings (or Team Space Settings if you have Team Space enabled)
  3. Open the Developers tab
  4. Click Create new API token

Keep your API token secure and never share it publicly.

Can I have multiple API tokens?​

Yes, you can create multiple API tokens. This is useful for separating access between different applications or environments.

What happens if my API token is compromised?​

You can revoke any API token at any time from your Account Settings. Once revoked, the token will immediately stop working. Create a new token to continue using the API.

Credits & Pricing​

How does API pricing work?​

API usage consumes credits from your Napkin account—the same credits used by the app. Each visual generation request deducts credits based on your plan.

How can I check my remaining credits?​

You can view your credit balance in your Account Settings at app.napkin.ai.

What happens when I run out of credits?​

When you run out of credits, API requests will fail with a no_credits error. You have several options:

  • Upgrade your plan: Get more monthly credits by upgrading to a higher tier
  • Top up credits: Purchase additional credits without changing your plan
  • Wait for refresh: Credits refresh based on your billing cycle

For high-volume needs, contact us to discuss custom plans.

Are there different pricing tiers?​

Yes, Napkin offers different subscription plans with varying credit allocations. Visit app.napkin.ai to view available plans and pricing.

Making API Requests​

How do I send a request to generate visuals?​

See the Create Visual Request documentation for complete details on how to submit requests.

How do I check the status of my request?​

Visual generation is asynchronous. After submitting a request, poll the status endpoint using the request ID. See the Get Visual Request Status documentation for details.

How long does it take to generate visuals?​

Most requests complete within 10-30 seconds, depending on complexity and server load. Poll the status endpoint to check when your visuals are ready.

What formats can I export visuals in?​

The API supports three output formats:

  • SVG: Scalable vector graphics (default)
  • PNG: Raster images
  • PPT: PowerPoint presentations

High Volume & Enterprise​

I expect high API volume. What should I do?​

For high-volume usage or enterprise needs, contact us to discuss custom contracts with:

  • Higher rate limits
  • Volume-based pricing
  • Dedicated support
  • Custom SLAs

Are there rate limits?​

Yes, API requests are rate-limited based on your plan. If you exceed the limit, you'll receive a 429 Too Many Requests response. Wait before retrying or contact us for higher limits.

Watermarks & Branding​

Will my visuals have watermarks?​

Watermarks only appear for free users without a paid subscription. Once you upgrade to any paid plan, all generated visuals will be watermark-free.

Can I use custom styles or branding?​

Yes! Napkin offers 21 built-in professional styles, and you can create custom styles to match your brand. See the Styles documentation for more details.

Troubleshooting​

Why am I getting a "no_credits" error?​

This means your account has run out of credits. You can:

  • Upgrade your plan for more monthly credits
  • Use the top-up feature to purchase additional credits
  • Wait for your credits to refresh on your next billing cycle
  • Contact us for high-volume custom plans

Why am I getting a "no_visuals" error?​

This error occurs when the system couldn't generate any visuals for your content. Try:

  • Simplifying your content
  • Using different parameters
  • Breaking long content into smaller chunks

What's the difference between errors and warnings?​

  • Errors indicate critical failures where no visuals were generated (e.g., no_credits, no_visuals)
  • Warnings indicate partial issues where some visuals may still be available (e.g., not_enough_visuals, some_visuals_failed_orientation_control)

Changelog​

Where can I find the API changelog?​

You can view all API updates, new features, and changes in our Changelog.

Need Help?​

If you're facing any issues with the API or have questions not covered in this FAQ, don't hesitate to reach out. Our team is here to help!