Changelog
Dated notes for the Socaity SDK, APIPod, and the hosted platform. Current versions: socaity 0.1.6, apipod 1.0.4.
Draft. Entries below are examples of the format we'll use once we cut versioned releases. Anything labelled (planned) is on the roadmap and not yet shipped.
socaity (Python SDK)
- Replicate-backed models reachable via
from socaity.sdk.replicate.<vendor> import <model>. Example:from socaity.sdk.replicate.black_forest_labs import flux_schnell. - Official services
face2faceandspeechcraftreachable viafrom socaity import .... Job.get_result(timeout_s=...)returnsNoneon timeout and re-raisesTaskExceptionon failure.- Polling defaults: 1 s interval, 3600 s total timeout. Up to 4 consecutive polling errors tolerated, raising on the fifth.
runtime_inforeturns(delay_seconds, execution_seconds)for RunPod and Replicate jobs.
apipod
- CLI deploy subcommands:
socaity scan,socaity build [FILE],socaity start(delegate to APIPod). @app.endpoint(path, queue_size=500)on the FastAPI router.get()andpost()shortcuts defaultqueue_size=100.JobProgress.set_status(progress, message)takesprogressas a float in[0, 1.0].- Default orchestrator
local, default computededicated, default providerlocalhost. Default port8000, host0.0.0.0. - Working providers:
localhost,runpod.scalewayandazureraiseNotImplementedError(planned).
Platform
- Marketplace catalog at socaity.ai with 1,200+ services across Text, Audio, Image, Video, Animation, and Misc.
- Active-only billing: charged for GPU-seconds in
PROCESSINGstate. Idle, queued, cold-start, failed, and cancelled jobs are not billed. - Subscription plans (Plus, Pro, Ultimate) and pay-per-call pricing listed at socaity.ai/Pricing.
- Serverless GPU on RunPod (EU and US regions). Dedicated GPU on Socaity-managed European infrastructure.
JavaScript SDK
npm install socaityships low-level helpers:setApiKey,getAvailableModels,getJobs,cancelJob.- High-level methods (
chat,text2img,text2voice) are planned. - Runs in Node.js and the browser.
Models at launch
| Model | Type | Provider |
|---|---|---|
| FLUX.1 Schnell | Image | Black Forest Labs |
| DeepSeek V3 | Chat/Text | DeepSeek |
| SpeechCraft | Voice | Socaity (official) |
| face2face | Face swap | Socaity (official) |
| wan-2.2 Planned | Video | Alibaba |
Items below are planned, not shipped. Each will get its own dated entry above when it lands.
| Feature | Status |
|---|---|
Unified socaity CLI (deploy, login, push) | Planned |
| Webhook result delivery | In development |
| Scaleway and Azure provider support in APIPod | Planned |
Celery backend for socaity + dedicated + runpod | Planned |
| Video generation models | Planned |
| MCP protocol support | Planned |
| OpenAI-compatible LLM endpoints | Planned |