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, and Sogni Photobooth 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? Sogni Restore for iOS or restore.sogni.ai.
- 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.
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.
- Premium Spark Points — see About Premium Spark Points. Holders are boosted to Premium Tier with access to premium licensed models (like Flux.2 Dev and Flux.1 Krea), 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; Flux.2 for photoreal or context-heavy 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, Flux.2 Dev 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 Safe 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 Flux.1 Krea or another 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, Flux.2 context editing, PaintOver — when do I use each?
- Flux.2 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 Flux.2 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, 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 Safe 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 — three 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 Client SDK (
@sogni-ai/sogni-clienton npm) — TypeScript/JavaScript SDK for Node and browser environments 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, plus Sogni Photobooth 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 — 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. The trial includes generous evaluation limits (a daily job cap, an overall trial render allowance, and standard image/video size limits; API access is limited during the trial); full plan limits apply once your paid period begins.
See Unlimited Plan Details for the full model list, limits, and management guide.
Which models are included in an Unlimited subscription?
Most supported open-source image, video, music, and LLM models are included on both tiers — including Krea 2 Turbo, Z-Image Turbo, Chroma, Qwen Image Edit 2511 Lightning, Flux.2 Dev, FLUX.1 Krea Dev, and Ace-Step 1.5 XL. The Sogni Intelligence / Creative Agent and SDK/API access are included on both tiers.
Not included in any subscription tier: GPT Image 2, Seedance 2.0 / Seedance 2.0 Fast / Seedance 2.0 Mini, and HappyHorse 1.1 — these are third-party vendor API models that always require Premium Spark.
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 the subscription payment model and platform fair-use scheduling. Fast requests can use subscription capacity while your tier has available effective capacity; if fast-lane fair-use is exhausted, the job can be demoted to a throttled, lower-priority queue and may wait longer during peak demand. Subscription priority is below paid Spark/SOGNI priority and above free Spark; demoted (throttled) subscription jobs run in a lower-priority queue until fair-use capacity is available again. If you want fastest paid priority on a specific job, you can still pay with Premium Spark.
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 / 1 video jobs in parallel; Unlimited Pro allows up to 16 image / 4 video jobs in parallel.
- Generate queue limits: Subscription plans also have per-account queue limits. Active-job concurrency and queue limits define practical throughput and may fluctuate with demand and available Supernet capacity.
- Fair-use controls: Very high volume, automation, or usage beyond normal fair-use averages may receive lower effective concurrency, lower queue priority, or throttling. Heavy-usage based throttles reset each UTC day.
- Model limits: Current model-level output limits still apply.
For full details see Limits & throttling.
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.
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.
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]. See Refunds 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.