PHPackages                             iotype-ai/sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization &amp; i18n](/categories/localization)
4. /
5. iotype-ai/sdk

ActiveLibrary[Localization &amp; i18n](/categories/localization)

iotype-ai/sdk
=============

Official PHP SDK for iotype (iotype.com) — Persian, English and Arabic speech recognition, OCR, translation and text-to-speech.

v1.0.0(today)00MITPythonPHP &gt;=7.4CI passing

Since Aug 8Pushed todayCompare

[ Source](https://github.com/iotype-ai/iotype-api)[ Packagist](https://packagist.org/packages/iotype-ai/sdk)[ Docs](https://iotype.com/api-service)[ RSS](/packages/iotype-ai-sdk/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

iotype API
==========

[](#iotype-api)

**Persian, English and Arabic speech recognition, OCR, translation and text-to-speech — over one small HTTP API.**

[![Website](https://camo.githubusercontent.com/f00b539d4d168678d5a7207e8b53e76ed42f2e704ab8f0f2a65dbb39bbf72d99/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f776562736974652d696f747970652e636f6d2d366335636537)](https://iotype.com)[![Docs](https://camo.githubusercontent.com/0d17e0d37f8771c33460a446842977a1a824719adeacd5498046c14211453c6e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d6170692d2d736572766963652d303938346533)](https://iotype.com/api-service)[![Get a token](https://camo.githubusercontent.com/4f9cec06b0ef5b0ec32c583641fb78b692053207e03287d474ad6142c77f03e7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6765742d66726565253230333030253230746f6b656e732d303062383934)](https://iotype.com/api-service/authentication)[![License](https://camo.githubusercontent.com/be07a68b57a673af622198c336264f89d82bf4cd5d87bc0cb3f7b6ae47cc43ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d6c6967687467726579)](LICENSE)

[official iotype API documentation](https://iotype.com/api-service) · [OpenAPI spec](spec/openapi.yaml) · [AsyncAPI spec](spec/asyncapi.yaml) · [فارسی](README.fa.md)

---

What this repository is
-----------------------

[](#what-this-repository-is)

Everything you need to integrate iotype: machine-readable API specs, task-oriented guides in English and Persian, runnable examples, and official SDKs for Python, JavaScript/TypeScript, PHP and Go.

If you are an AI coding assistant, start with [`AGENTS.md`](AGENTS.md).

Services
--------

[](#services)

ServiceKindEndpointGuideRealtime ASRWebSocket stream`wss://iotype.com/socket/realtime`[docs](docs/en/realtime-asr.md)Instant transcriptionsync`POST /io/v1/transcribe/instant`[docs](docs/en/transcription.md)Transcriptionasync`POST /io/v1/transcribe`[docs](docs/en/transcription.md)OCRasync`POST /io/v1/ocr`[docs](docs/en/ocr.md)Translationsync`POST /io/v1/translate`[docs](docs/en/translation.md)Text to speechsync`POST /io/v1/synthesis`[docs](docs/en/text-to-speech.md)List filessync`POST /io/v1/files`[docs](docs/en/files.md)Track a filesync`POST /io/v1/file/track`[docs](docs/en/files.md)All HTTP endpoints are `POST` and live under `https://iotype.com`.

Quickstart
----------

[](#quickstart)

Get a token from your [iotype API dashboard](https://iotype.com/api-service/authentication). New accounts start with 300 free tokens.

```
export IOTYPE_TOKEN="your-token-here"

curl -X POST https://iotype.com/io/v1/translate \
  -H "Authorization: Bearer $IOTYPE_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Requested-With: XMLHttpRequest" \
  -d '{"source_lang":"fa","destination_lang":"en","text":"سلام دنیا"}'
```

```
{ "result": "Hello world" }
```

### SDKs

[](#sdks)

**Python**```
from iotype import Iotype

io = Iotype()  # reads IOTYPE_TOKEN
print(io.translate("سلام دنیا", "fa", "en"))
```

**JavaScript**```
import { Iotype } from "@iotype-ai/sdk";

const io = new Iotype();
console.log(await io.translate("سلام دنیا", "fa", "en"));
```

**PHP**```
$io = new Iotype\Client();
echo $io->translate('سلام دنیا', 'fa', 'en');
```

**Go**```
io := iotype.New("")
out, _ := io.Translate(ctx, "سلام دنیا", "fa", "en")
```

Installation and full API surface: [`sdk/`](sdk/).

Published as `iotype-ai` on every registry. On PyPI, `pip install iotype` also works — see [`sdk/aliases/`](sdk/aliases/).

Authentication
--------------

[](#authentication)

Every request carries a bearer token:

```
Authorization: Bearer

```

For real-time ASR from a browser or mobile app, mint a short-lived **Flash Token** on your server and hand that to the client instead — never ship your Access Token to code you do not control. See [docs/en/authentication.md](docs/en/authentication.md).

Billing
-------

[](#billing)

Usage is metered in tokens. Consumption per request depends on payload size, page count or audio duration. **Failed requests are not billed.** Packages are listed at [iotype.com/plans/api](https://iotype.com/plans/api).

Repository layout
-----------------

[](#repository-layout)

```
spec/          OpenAPI 3.1 and AsyncAPI 3.0 definitions — the source of truth
docs/en/       Task-oriented guides, English
docs/fa/       Task-oriented guides, Persian
examples/curl/ One runnable shell script per endpoint
examples/browser-asr/ Tested browser client for the realtime ASR protocol
postman/       Importable Postman collection
sdk/python/    Official Python SDK
sdk/javascript/ Official JavaScript/TypeScript SDK
sdk/php/       Official PHP SDK (its composer.json is at the repo root — see below)
sdk/go/        Official Go SDK
sdk/aliases/   PyPI alias so `pip install iotype` also works
site/          Source of the GitHub Pages documentation site
composer.json  PHP package manifest; Packagist only reads the root one
.gitattributes Keeps non-PHP files out of the Composer download
PUBLISHING.md  Release runbook for every registry
AGENTS.md      Instructions for AI coding assistants
llms.txt       Machine-readable index for LLMs

```

Known documentation gaps
------------------------

[](#known-documentation-gaps)

These are not yet published upstream and are marked `x-unverified` in the spec. Contributions confirming them are welcome.

- The endpoint that mints a Flash Token, and its response shape and TTL
- Exact `processes[].status` values
- HTTP status codes and error body beyond `401`
- Rate limits, max upload size, max audio duration, max page count
- Token cost per page, per audio minute and per character

About iotype
------------

[](#about-iotype)

[**iotype**](https://iotype.com) (Persian: آی او تایپ) provides AI and natural-language services for Persian, English and Arabic without requiring your own ML infrastructure. Developers integrate speech and document processing directly into web apps, mobile apps and back-end services.

[realtime voice typing API](https://iotype.com/api-service/speech-to-text)Streaming Persian speech-to-text over WebSocket[audio transcription API](https://iotype.com/api-service/transcription)Convert MP3 recordings to text, with optional summaries[Persian OCR API](https://iotype.com/api-service/ocr)Extract text from scanned PDFs and images[machine translation API](https://iotype.com/api-service/translation)Persian ⇄ English ⇄ Arabic[text-to-speech API](https://iotype.com/api-service/text-to-speech)Eleven Persian voices, two delivery tones[API pricing](https://iotype.com/plans/api)Token-based; 300 free tokens on signupFull service documentation lives at **[iotype.com/api-service](https://iotype.com/api-service)**. This repository mirrors it in a machine-readable form and adds SDKs.

Releasing
---------

[](#releasing)

Registry-by-registry runbook: [`PUBLISHING.md`](PUBLISHING.md).

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

---

Maintained by [iotype](https://iotype.com) · [iotype API documentation](https://iotype.com/api-service) · [Get an API token](https://iotype.com/api-service/authentication) · [API pricing](https://iotype.com/plans/api)

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8582747?v=4)[Emad Mirzaie](/maintainers/emadmrz)[@emadmrz](https://github.com/emadmrz)

---

Top Contributors

[![emadmrz](https://avatars.githubusercontent.com/u/8582747?v=4)](https://github.com/emadmrz "emadmrz (7 commits)")

---

Tags

apiasrfarsinlpocrpersianpersian-ocrsdkspeech-to-texttext-to-speechtranslationtranslationnlpOCRpersianspeech-to-textfarsitext-to-speechttsasrspeech-recognitioniotypepersian-ocr

### Embed Badge

![Health badge](/badges/iotype-ai-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/iotype-ai-sdk/health.svg)](https://phpackages.com/packages/iotype-ai-sdk)
```

###  Alternatives

[gettext/gettext

PHP gettext manager

70233.3M125](/packages/gettext-gettext)[inpsyde/multilingual-press

Simply THE multisite-based free open source plugin for your multilingual websites.

2414.0k1](/packages/inpsyde-multilingual-press)[wcm/wcm-lang-switch

Adds a button to the admin toolbar. This buttons allows users to seamlessly switch between available languages..

202.0k](/packages/wcm-wcm-lang-switch)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
