Troubleshooting

“Generation Failed”

This means your AI provider returned an error. The message underneath comes from the provider and usually says why. The most common causes:

• Invalid or revoked key. Copy a fresh key from the provider’s console and add it again in Settings → Models.
• No credit or billing not set up. API accounts are billed separately from chat subscriptions. Add a payment method or credits in the provider’s console.
• Rate limit or overloaded. Wait a moment and tap Try Again.
• No connection. Check your network. Apple Intelligence works offline; cloud providers don’t.

“API Key Needed”

The selected provider has no key on this device. Add it in Settings → Models, or turn on iCloud Keychain there so keys you added on another device show up. See Adding an API key.

Apple Intelligence isn’t available

Apple Intelligence needs a supported device, a supported OS version, and Apple Intelligence turned on in your device’s Settings. It also may need to finish downloading its model after you turn it on. It isn’t available on Apple Watch. Until it’s ready, use a cloud provider.

Pressing Return does nothing, or Settings opens instead

Postout needs three things to draft: a provider that’s ready, at least one enabled platform, and either an active trial or the unlock. If one is missing, you’ll see a message telling you which. If Auto-Generate Topic is off, or Confirm Settings Before Creating is on, Post settings opens first so you can choose before creating.

Drafts are too long or ignore the style

• Check the platform’s Character Limit and Prompt Instruction in Settings → Social Platforms. Tightening the instruction helps most.
• Update your personality profile with more specific details.
• Smaller models, including Apple Intelligence and small local models, follow long instructions less reliably. Try a larger cloud model for long-form templates.
• Reroll a single card for another take.

“Couldn’t create your profile”

The questionnaire uses your AI provider to write your profile. Make sure a provider is set up and working, then tap Try Again. Or skip it and write your profile by hand with Edit in Settings → Personality.

Drafts aren’t syncing

Make sure every device is signed in to the same Apple Account with iCloud on, then keep Postout open for a minute. More in iCloud sync.

My purchase isn’t recognized

Tap Restore Purchase in Settings → Unlock Postout, signed in to the App Store with the Apple Account you bought with. Family members need Family Sharing turned on for purchases. See Pricing and unlocking.

Still stuck?

Contact support with your device, OS version, the provider you’re using, and what you were doing. Testing the beta? Sending feedback from TestFlight includes those details automatically. See Joining the TestFlight beta.