FAQs
Frequently asked questions about Sogni — for creators, developers, and workers. Looking for a deeper guide on a specific topic? Use the navigation or search.
#Start here
What is Sogni?
Sogni is a creative platform built on a decentralized GPU network — the Sogni Supernet — with privacy and ownership at the core. On top of the network, Sogni Intelligence provides an OpenAI-compatible LLM service that can generate and edit images, video, music, and text. The Supernet and Intelligence are surfaced through 10+ SuperApps (Pocket, Studio, Create, Photobooth, Chat, 360, Makeover, Restore, Voice, Vibe, Gen) and the Sogni SDK for developers who want to build their own.
Which Sogni app should I use?
Pick what fits the moment:
- Just want to chat with AI? chat.sogni.ai — a conversational creative assistant.
- iPhone or iPad? Sogni Pocket on the App Store.
- Android? Sogni Create for Web and Android is on Google Play, Sogni Photobooth is on Google Play, and Sogni Restore is on Google Play.
- Mac desktop? Sogni Studio (App Store) or Sogni Studio Pro (from sogni.ai/download) — Pro adds Worker Mode and the full Web3 wallet.
- Any browser, nothing to install? app.sogni.ai and the SuperApps: photobooth.sogni.ai, 360.sogni.ai, makeover.sogni.ai, restore.sogni.ai, and others linked from sogni.ai/super-apps.
- Restoring old photos? Use Sogni Restore on the web, iOS, or Android via Google Play.
- Building your own app? The Sogni SDK and the Sogni Intelligence API.
Is Sogni private?
Yes. Sogni is built with privacy and ownership at the core:
- With on-device processing, your prompts and images never leave your device.
- With Supernet processing, prompts and assets are encrypted and routed through permissionless workers who never see or store your content. Your wallet is only used to verify identity and reward activity.
- Your wallet is yours. You alone hold the private keys — Sogni never has access to your funds, account, or data.
@@HTML_BLOCK_0@@
Can I use Sogni without a crypto wallet?
Yes. Sign up at app.sogni.ai with just an email. Inside any Sogni app you can purchase Premium Spark Points with Apple Pay or any credit/debit card via Stripe — supported in 195 countries and 135 currencies. A Sogni wallet is created for you automatically; you never have to handle keys, gas, or chains. You can connect or import a wallet later if you want to use SOGNI tokens directly, or pay with USDC/USDT stablecoins if you prefer crypto.
How does pricing work? Spark Points vs Premium Spark vs SOGNI tokens
Jobs are priced in GPU-time. One Spark Point equals one base render job (an SDXL model at 20 steps), pegged to $0.005 of GPU-time on the Supernet — so 1 Spark = 1 base render, every time.
- Free Spark Points — earned from the Monthly Boost (400 Spark/month), referrals, email verification, and quests. 1× leaderboard multiplier. Collecting and spending free Spark requires a verified payment method on accounts created in the Sogni web app — a 3-day free Unlimited trial or any Premium Spark purchase unlocks it permanently. See Monthly Boost eligibility.
- Premium Spark Points — see About Premium Spark Points. Holders are boosted to Premium Tier with access to provider-backed premium models, queue priority, full worker-targeting control, and a 10× Artist leaderboard multiplier.
- SOGNI tokens — fully transferable ERC-20 on Base and Etherlink. Pay-as-you-go for renders, claim worker earnings, stake for the Staking Leaderboard, and vote in future governance. 10× leaderboard multiplier when used to pay.
Sogni is pay-as-you-go with optional Unlimited Plan subscriptions. Spark packs are always available; subscriptions add credit-free fair-use access to most supported open-source models on top of them.
See SOGNI Token vs Spark Points for the full breakdown.
How do referrals work?
Share your referral code (your Sogni username), or send a link in the format https://app.sogni.ai/create?code=<your-username>. After a friend signs up with your code and confirms their email, they get 25 Spark Points. After their first Spark purchase, you get 25 Spark Points too.
Referrals also feed the Ambassador Leaderboard — every Sogni user is enrolled automatically. Points accrue from purchases by you, your referrals, and the people they refer, with the leaderboard distributing one of the largest slices of each 6-week seasonal airdrop pool.
#Creating
What is the Creative Assistant and which mode should I use?
The Creative Assistant is the agentic AI layer in Sogni Studio, Sogni Pocket, and the Sogni Creative Agent. Tell it what you want and it picks models, writes prompts, runs multi-step workflows, and edits or analyzes media. It understands the Sogni UI, Supernet, your assets, and your safety filter settings.
- Agent Mode — chat-first. Tell it what you want and it assembles the workflow for you.
- Guided Mode — chat with controls. The assistant helps; you decide which settings to commit to.
- Manual Mode — the classic Sogni workflow, untouched.
The same brain is available at chat.sogni.ai.
I'm not getting the image I described in my prompts — any tips?
- Try the Creative Assistant in Agent or Guided Mode — it picks the right model and settings from your description.
- Pick a model that matches the result. Krea 2 Turbo for the newest fast open-source image model with strong in-image text; Z-Image Turbo for fast default image generation; Chroma v46/v48 for stylized work; Qwen Image Edit 2511 Lightning for fast precise edits; Qwen Image 2512 for photoreal work. The Model Explorer has descriptions and sample settings.
- Iterate with edits instead of regenerating from scratch. Use Qwen Image Edit 2511 Lightning for fast instruction edits, full Qwen Image Edit for heavier natural-language reference edits, PaintOver for "change only this region," and Auto-Refresh to stack edits fast.
- Adjust Steps and Guidance Scale. Higher steps add detail; a lower Guidance Scale (5–6) softens results for photoreal work.
- Use a Guide Image or ControlNet to give the model a reference.
- Check the Sensitive Content Filter in the Advanced tab.
Tutorial videos: youtube.com/@SogniAI. Prompt-writing tutorial.
How do I keep faces consistent across renders? (Personas)
Personas let you save people — yourself, family, friends, pets — once, and refer to them by name in any prompt. You can also define how they should sound in LTX-2.3 audio and add backstory the assistant uses when building scripts.
For one-off photoreal portraits without setting up a Persona:
- Use Krea 2 Identity Edit or another identity-preserving photoreal model.
- Add face-related keywords ("perfect face," "highly detailed face").
- Lower the Guidance Scale to 5–6 for softer lighting and skin.
- Turn off automatic upscaling in the Advanced tab — over-smoothing can flatten skin texture.
ControlNet, Qwen context editing, PaintOver — when do I use each?
- Qwen context editing — natural-language edits on reference images. Best for "change the shirt to red," group-photo merges, image blends, and identity-preserving edits. Runs on Fast Supernet.
- PaintOver — paint directly over the region you want changed. Best for targeted edits where prompts aren't precise enough. Works alongside Guide Images, ControlNet, and Qwen context editing.
- ControlNet — classic Stable Diffusion guidance with 14 CN models (Canny, Depth, InPaint, Instant-ID, Instruct Pixel2Pixel, LineArt, LineArt Anime, M-LSD, Normal Bae, OpenPose, Scribble, Segmentation, Shuffle, Soft Edge, Tile Resample) and preprocessors (Vision Face/Pose, Sketch, Depth Map, Segmentation, Subject/Background Mask, Invert). Best for pose transfer, depth maps, and structural reuse.
See ControlNet Models.
What video, audio, and motion features does Sogni offer?
- Wan 2.2 — the default text-to-video and image-to-video engine.
- LTX-2.3 — cinematic video up to 2160p (4K) with synchronized audio (dialogue, SFX, music) in a single pass, roughly 5× faster per frame than Wan 2.2. Includes Depth, Canny, and Pose IC-LoRA controls.
- Motion Transfer — Animate-Move (apply a video's motion to your character) and Animate-Replace (keep the original motion, swap the subject). You can record movements directly from your Mac's webcam.
- Sound to Video — drive image motion from an audio track (music videos, lip-sync, ambient scenes).
- Change Perspective — re-render an image from any camera angle while keeping subject and style consistent. 96 distance/orientation/elevation combinations.
- Sogni 360 — turn a single image into a smooth 360° orbit video.
- Clip Mixer — combine clips with Fast Combine, High Quality, or Share-safe export modes.
Premium hosted video — ByteDance Seedance 2.0, including Seedance 2.0 Mini, ByteDance Seedance 2.5, and Alibaba HappyHorse 1.1 — is also available with Premium Spark.
What size are the images and videos generated by Sogni?
Images — most models generate at 1024 × 1024 px (or another aspect ratio at the same megapixel count). With upscaling enabled you can boost to 2048 × 2048 px. Sogni Studio offers three upscalers:
- Z-Image Upscale (Supernet) — best for diffusion-generated images, with strong structure and detail retention.
- Real-ESRGAN (on-device) — fine photographic detail.
- Real-ESRGAN Anime (on-device) — illustrations and line-art.
Video — Wan 2.2 outputs standard HD resolutions; LTX-2.3 supports up to 2160p / 4K with embedded synchronized audio.
Can I import custom Stable Diffusion models?
Yes, for on-device processing in Sogni Studio. Import any Stable Diffusion model that has been converted to Core ML — downloaded from the web or trained by you — via File → Import S.D. Core ML model. See Importing Stable Diffusion Models. The Supernet manages its own model catalog and does not accept end-user uploads.
How do I save my creations?
- Sogni Pocket — swipe up to save to your Sogni Gallery, or tap the share button → Save Image (Photos) / Save to Files.
- Sogni Studio / Studio Pro — File → Save, the save button in the main window, drag-and-drop from the gallery, or right-click → Save Image / Save a copy.
- Sogni Create (web) — download from the result card. The Supernet supports both JPG (5–10× smaller, great for batch reviews) and PNG (lossless); toggle in the Advanced menu.
- SuperApps (Photobooth, 360, Makeover, Restore, …) — built-in download and share controls on each result.
What does the Sensitive Content Filter do?
The filter detects images that may contain potentially disturbing content — graphic violence, nudity, sexual, vulgar, or NSFW content. If detected, the image isn't displayed and you'll see an error instead. You must be 18+ to turn the filter off.
#Developers and workers
What is Sogni Intelligence and how do I get an API key?
Sogni Intelligence is an OpenAI-compatible LLM service running on the Sogni Supernet. The default model is Qwen 3.6 35B-A3B (qwen3.6-35b-a3b-gguf-iq4xs) with a 262K-token context window, reasoning, and tool calling.
- Base URL:
https://api.sogni.ai(requests go to/v1/...). - Pricing: roughly $0.30 per 1M input tokens and $0.90 per 1M output tokens, billed in Spark or SOGNI.
To get a key:
- Sign up at app.sogni.ai.
- Open dashboard.sogni.ai/api-key.
- Use the eye icon to reveal it, copy it, and send it as
Authorization: Bearer YOUR_API_KEY.
The same key works with the Sogni SDK and Fast Worker. See the Sogni Intelligence Introduction and the LLM API reference.
Can I build my own apps on Sogni?
Yes — four paths:
- Sogni Intelligence API (
/v1/chat/completions) — OpenAI-compatible. Any client that supports a custom OpenAI endpoint works: Open WebUI, OpenClaw, Hermes Agent, the OpenAI SDK, and agentic coding clients. Sogni auto-injects six built-in media tools (sogni_generate_image,sogni_edit_image,sogni_generate_video,sogni_sound_to_video,sogni_video_to_video,sogni_generate_music) so the model can produce media inline. - Sogni Python SDK (
sogni-client) — official async Python 3.10+ client for scripts, backends, notebooks, agents, and automation, with generation, uploads, LLM chat, hosted tools, and durable workflows. - Sogni TypeScript SDK (
@sogni-ai/sogni-clienton npm) — Node and browser client with WebSocket-based job processing for images, video, LLM chat, and tool calling. - n8n — drop-in nodes for no-code automations. See Sogni n8n Plugin.
How do I run a Fast Worker or LLM Worker and earn?
- Sogni Fast Worker (image/video) — Docker-based, runs on Windows or Linux with a supported Nvidia GPU (≥16 GB VRAM, including RTX 5090/4090, H100, RTX Pro 6000; full list in the Fast Worker docs). Install from api.sogni.ai/v1/download/worker/windows or api.sogni.ai/v1/download/worker/linux. A high-end RTX 5090 can complete up to ~10,000 image jobs per day at peak demand.
- Sogni LLM Worker (Intelligence) — powers Qwen 3.6 and other LLMs. Requires ≥24 GB VRAM. Earnings track token throughput at roughly $0.30/M input tokens and $0.90/M output tokens. Use the same Fast Worker installer.
- Worker Mode in Sogni Studio Pro (macOS) — a Mac-friendly entry point for sharing idle compute.
For requirements, configuration, and the full Fast Worker FAQ, see the Fast Worker section.
Is it safe to share my compute power on the Supernet?
Yes. Whether you're running Worker Mode in Sogni Studio Pro (macOS), the Sogni Fast Worker (Windows/Linux Docker), or the Sogni LLM Worker, your machine processes encrypted jobs in a sandboxed environment, isolated from the rest of your system. Your personal files, prompts, and data are never exposed. You can pause or stop working at any time, and earnings accumulate in your Sogni account.
#Platform and devices
What platforms is Sogni on?
- Web (any browser) — app.sogni.ai plus all SuperApps (chat, photobooth, 360, makeover, restore, and others).
- macOS — Sogni Studio (App Store) and Sogni Studio Pro (sogni.ai/download). Pro adds Worker Mode and full Web3 wallet features.
- iOS / iPadOS — Sogni Pocket and Sogni Restore on the App Store.
- Android — Sogni Create for Web and Android on Google Play, Sogni Photobooth on Google Play, and Sogni Restore on Google Play.
- Windows / Linux — Sogni Fast Worker and Sogni LLM Worker via Docker.
See sogni.ai/download for current install links.
What are the minimum system requirements?
Native macOS / iOS apps support both on-device and Supernet processing:
- macOS Sonoma 14.0+ — Apple silicon; 16 GB RAM recommended.
- iOS 17+ — iPhone 13 Pro or later, or iPad with Apple silicon.
Older devices may be unable to compile the Core ML on-device models, but can still use the Supernet through any browser or native app.
Fast Worker — Windows or Linux with Docker and a supported Nvidia GPU (≥16 GB VRAM). LLM Worker — ≥24 GB VRAM.
Web and SuperApps — any modern browser, no install required.
@@HTML_BLOCK_1@@
Which blockchain does Sogni run on?
SOGNI is an ERC-20 token on Base, with availability extended to Etherlink. The Supernet uses Etherlink as the default layer for faster, lower-cost transactions. Workers can bridge their Worker License NFT from Base to Etherlink with nft.sogni.ai and earn a +2% bonus on settlements while it's on Etherlink. Bridging is powered by LayerZero V2 and typically takes 2–5 minutes.
#Unlimited subscription plans
What is the Sogni Unlimited plan?
Sogni Unlimited ($20/mo or $199/yr) and Unlimited Pro ($50/mo or $498/yr) are subscription plans that give you credit-free fair-use access to most supported open-source models on the Sogni Supernet. Covered jobs do not spend Spark or SOGNI; they run against your subscription entitlement with fair-use scheduling, active-job concurrency, and generate queue limits. A 3-day free trial is available for new subscribers on card plans — a valid payment method is required to start the trial, eligibility is limited to one trial per person, and canceling during the trial prevents the first charge while ending Unlimited access immediately. Additional evaluation and anti-abuse limits apply during the trial; regular plan allowances begin once your paid period starts. You never need to cancel to start paying: on the web you can skip the trial at checkout, or end a running trial early with End trial & start paid plan in Wallet & Billing (same plan and cadence, charged today). Apple and Google Play trials convert automatically at the end of the trial period and cannot be ended early.
You can pay by card, through the App Store or Google Play, or by prepaying in USDC/USDT. Crypto plans are one-time prepaid purchases: they never auto-renew and have no free trial.
See Unlimited Plan Details for the full model list, limits, and management guide.
Why did my bank show a pending amount when I started a free trial?
When a card-based Sogni Unlimited trial starts, Sogni may ask the card issuer to authorize an amount up to the subscription's first payment. This is a temporary verification hold, not a completed charge. Sogni releases the authorization immediately without capturing the funds, although some banks may continue to display it as pending until their own processing catches up.
If the authorization cannot be approved — for example, because the card has insufficient available credit, does not allow online charges, or is declined by the issuer — Sogni automatically ends the trial before any subscription payment is taken. We send an email and an in-app notice explaining what happened. Because the trial is already canceled, Manage billing or Update Plan may no longer appear and there is nothing else to cancel. The trial is not counted as used, so you can start it again with a standard credit or debit card that has enough available balance, or begin a paid subscription directly. Until a valid card is on file, free generations and free reward claims on the account are paused.
Free trials use real Supernet capacity. Verifying that the payment method can support the subscription if the customer chooses to continue helps keep trial bandwidth fair and preserves reliable capacity for future paying subscribers.
Which models are included in an Unlimited subscription?
Most supported open-source image, video, music, and LLM models are included on both tiers — including MiniMax H3 and H3 Turbo, Krea 2 Turbo, Z-Image Turbo, Chroma, Qwen Image Edit 2511 Lightning, and Ace-Step 1.5 XL. The Sogni Intelligence / Creative Agent and SDK/API access are included on both tiers. Unless a release is specifically marked otherwise, newly supported open-weight models and related updates are automatically included for existing and new subscribers.
Not included in any subscription tier: GPT Image 2, Seedance 2.0 / Seedance 2.0 Mini, Seedance 2.5, and HappyHorse 1.1 — these are third-party vendor API models that always require Premium Spark. Legacy Seedance 2.0 Fast requests route to the faster, lower-cost Mini tier.
What differs between tiers: both tiers can run the same covered models; Unlimited Pro adds higher throughput, higher queue priority, and more generous fair-use allowances (see Unlimited Plan Details). The tiers differ by throughput, not by which models you can use.
Does an Unlimited plan replace Spark Points?
No. Spark Points remain the pay-as-you-go currency for all Sogni users. An Unlimited subscription adds credit-free fair-use access to covered models on top of your existing Spark balance. Premium Spark remains for fastest-priority queue access and for models not covered by any subscription tier.
What queue does my subscription use?
Subscription-covered jobs use platform fair-use scheduling, so wait times can vary with demand and available Supernet capacity. Unlimited Pro receives higher subscription queue priority than Unlimited. Within each tier, daily usage is a scheduling signal so accounts with lighter use are favored and more subscribers receive fast service with minimal queue time. Premium Spark remains available for fastest paid priority on a specific job.
Are there limits on how much I can generate with an Unlimited plan?
Yes. "Unlimited" means credit-free, not unmetered:
- Active-job concurrency: Unlimited allows up to 4 image jobs and 1 video job in parallel, or 2 video jobs with fast/turbo models. Unlimited Pro allows up to 16 image jobs and 4 video jobs, with standard MiniMax H3 limited to 2.
- Generate queue limits: Unlimited can queue up to 64 media, including 8 videos. Unlimited Pro can queue up to 192 media, including 24 videos. Active-job concurrency and queue limits define practical throughput and may fluctuate with demand and available Supernet capacity.
- Fair-use controls: Paid plans also have adaptive daily throughput limits. About 98% of normal fair-use subscribers never encounter daily throttling; exact thresholds are unpublished to prevent gaming and can shift with GPU supply and demand. Sustained high-volume or automated use may be delayed or rate-limited.
- Model limits: Current model-level output limits still apply.
For full details see Limits & throttling.
What MiniMax H3 speed and throughput should I expect on Unlimited?
On Sogni's primary NVIDIA RTX PRO 6000 H3 workers, a highest-quality 15-second standard H3 video typically takes about 15 minutes once rendering starts; H3 Turbo typically takes about 5 minutes. Raw render time is the same on both plans, but Unlimited Pro adds another standard H3 concurrency slot, higher queue priority, and twice the H3 fair-use capacity. Sogni is testing current community workflow optimizations that may improve H3 speed by up to 20%.
Sogni intentionally does not publish a fixed 24-hour H3 video count. The average paid subscriber does not encounter daily throttling, and actual throughput varies with workflow, worker availability, queue demand, and adaptive fair-use controls. Individual creators can keep substantial queues moving throughout the day through the API or Creative Agent Skill. Unattended continuous 24/7 infrastructure and multi-user production workloads are not fair use.
How do I subscribe, and how do I manage or cancel?
Subscribe at app.sogni.ai or dashboard.sogni.ai (Stripe web checkout) or through the App Store / Google Play. Web subscriptions are managed via the Stripe Customer Portal from your dashboard, including upgrades, downgrades, cancellations, payment method changes, prorations, and invoice previews. App Store / Google Play subscriptions are upgraded, downgraded, or canceled in your device's native store subscription settings. See Managing your subscription or follow the illustrated guide to cancel a web subscription.
To pay in stablecoins, use dashboard.sogni.ai — crypto payment is available there only, not in the apps or at app.sogni.ai. A crypto plan is prepaid and never renews, so there is nothing to cancel; upgrading to Unlimited Pro charges the prorated difference immediately. See Pay with Crypto.
When do cancellations, downgrades, and upgrades take effect?
You can cancel your subscription at any time. Cancellation turns off renewal, and you keep access until the end of your paid billing period. For web subscriptions, follow How to Cancel Your Sogni Unlimited Subscription.
Downgrades take effect at your next renewal date — you keep your current plan benefits until then. Upgrades may take effect immediately, with prorated billing or credit where the provider supports it.
If you reactivate before your paid period ends, renewal turns back on with no new charge. Resubscribing after the period has fully expired starts a new billing period. See Cancel and renew.
Can I get a refund on an Unlimited subscription?
Annual plans are discounted in exchange for a one-year commitment, so automatic prorated refunds are not provided for mid-term cancellations except where required by law, required by Apple or Google, or approved by Sogni support for billing, technical, or account issues (reviewed case-by-case).
Where to ask depends on how you purchased: Apple App Store purchases are refunded by Apple — use reportaproblem.apple.com; Google Play purchases follow Google Play's refund flows; web (Stripe) refund exceptions are reviewed by Sogni support at [email protected]. Crypto payments cannot be reversed on-chain; approved exceptions are handled manually in the same stablecoin, net of the network fee — contact [email protected]. See the Cancellation and Refund Policy for details.
Do recurring subscription payments count for Ambassador Points and referral rewards?
Yes. Recurring subscription renewals count toward Ambassador Points and referral rewards in the same way that other platform purchases do. See Referral Program / Sogni Ambassador Rewards.
If I run a worker, do I earn SOGNI for subscription jobs?
Regular Spark- and SOGNI-paid jobs still earn SOGNI for workers in real time. Subscription jobs are optional and accrue to the monthly Worker Subscription Revenue Share Pool instead of settling per job. Payouts are planned for approximately 45 days after the end of each UTC month to allow provider settlement and reconciliation. See Worker revenue share for opt-in, attribution, and payout details.
Need help? Ask in our Discord!
For any questions about using Sogni, tips, suggestions, bugs, sharing art, discussing AI and life, or simply hanging out — join our community.