RICOH Theta A1, X and Z1 provide Web APIs.
The Web API conforms to Open Spherical Camera API (OSC API) level 2 by Google. In addition to OSC API, vendor commands and vendor parameters are provided. The name of vendor commands and vendor parameters is prefixed with an underscore (”_”).
Either wireless LAN or wired LAN is used for communication between a client and Ricoh Theta. While LAN connection is on, Ricoh Theta acts as an HTTP 1.1 server and a client can call Web APIs by GET or POST requests.
To connect Theta to wired LAN, use an USB Ethernet adapter.
Theta does not support HTTPS but HTTP.
Thate’s IP address is 192.168.1.1 and the port of Web API is 80.
Theta’s SSID is a concatenation of THETA, its serial number, and .OSC (e.g., THETAYR12345678.OSC).
The initial encryption key varies depending on the model:
YR10, YR20 or YR30 and the firmware version at time of purchase is 2.80.1 or laterYN10, YN20, YN30, YN40 or YN50 and the firmware version at time of purchase is 3.50.2 or later
12345678).The encryption key can be changed through Web API.
Theta’s IP address is determined by a LAN router, and the port of Web API is 80.
Furthermore, HTTP digest access authentication is required.
The default username is a concatenation of THETA and its serial number (e.g., THETAYR12345678), and the default password varies depending on the model:
YR10, YR20 or YR30YN10, YN20, YN30, YN40 or YN50
12345678).The username and password can be changed through Web API.
In an environment where multicast DNS (mDNS) is available, Theta FQDN starts with THETA and ends with a serial number and .local (e.g., THETAYR12345678.local).
Calling Web APIs from Theta plugins, IP address of Web API is 127.0.0.1 and port is 8080.
URL paths of Theta Web API endpoints are defined in this section. HTTP method, request body, HTTP status code and response body of each endpoint are defined in the link destination page.
http://192.168.1.1/osc/info.http://192.168.1.1/osc/state.http://192.168.1.1/osc/checkForUpdates.http://192.168.1.1/osc/commands/execute.http://192.168.1.1/osc/commands/status.http://192.168.1.1/plugin.http://192.168.1.1/legal-information/open-source-licenses.http://192.168.1.1/log/eventLog.Some APIs may return an error response. See error codes for a description of each error.
Commands defined in this section can be executed using /osc/commands/execute API.
In this section, each command is defined depending on their purpose such as shooting, downloading and manipulating images, checking and changing the settings, receiving live preview stream and controlling plugins.
Option values can be gotten by camera.getOptions command, and can be set by camera.setOptions command.
To get supported values of enumerated type options, read only options, which are not described in following subsections, are also provided.
Their names are the concatenation of the target option name and “Support”. Their value is an array of supported values.
For example, to acquire the supported values for the iso option, get the value of isoSupport option.
In this section, each option is defined depending on their purpose such as shooting settings, multiple shooting settings, image processing settings, Theta settings, getting Theta state and microphone settings.
Even if a command or an option has the same name, the parameters that can be set may be different, or there are some that are defined only in one or the other. Refer the difference lists .
These API descriptions target the latest version of Theta firmware. Older versions may not have any options or parameters. Refer firmware change history.