> For the complete documentation index, see [llms.txt](https://docs.astronomyapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.astronomyapi.com/api-v3-reference-draft/v3/studio.md).

# Studio

Rendered images of the sky

The studio endpoints render an image and return a URL to it. Both take the same `observer` and `time`, and differ only in what they draw.

## What changed from v2

**`time` sits beside `observer`, not inside it.** v2 nested `date` within the observer object. A moment is not a property of a place, and every other endpoint treats them separately.

**Elevation is accepted.** v2's studio endpoints took only latitude and longitude and assumed sea level.

## ✨ Star Chart

{% openapi src="/files/I36OyRpmo4rQOx2DuT1k" path="/studio/star-chart" method="post" %}
[astronomy-api-v3.yaml](https://1238588302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKQ7_I-c79Ln1c6Chop-3789850253%2Fuploads%2Fgit-blob-c743ca2b9574a9aee2b1314404f74fd87c7a6cfc%2Fastronomy-api-v3.yaml?alt=media)
{% endopenapi %}

A chart can be framed either on a point in the sky with a zoom level, or on a named constellation.

```json
{
    "observer": { "latitude": 51.4779, "longitude": -0.0015, "elevation": 0 },
    "time": "2024-06-21T22:00:00Z",
    "view": {
        "type": "area",
        "parameters": {
            "position": { "rightAscension": 5.5, "declination": -5.4 },
            "zoom": 4
        }
    },
    "style": "default"
}
```

v2 wrapped the position in a further `equatorial` object. There is only one frame involved, so v3 does not.

## 🌒 Moon Phase

{% openapi src="/files/I36OyRpmo4rQOx2DuT1k" path="/studio/moon-phase" method="post" %}
[astronomy-api-v3.yaml](https://1238588302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKQ7_I-c79Ln1c6Chop-3789850253%2Fuploads%2Fgit-blob-c743ca2b9574a9aee2b1314404f74fd87c7a6cfc%2Fastronomy-api-v3.yaml?alt=media)
{% endopenapi %}

```json
{
    "observer": { "latitude": 51.4779, "longitude": -0.0015, "elevation": 0 },
    "time": "2024-06-21T22:00:00Z",
    "view": { "type": "portrait-simple", "orientation": "north-up" },
    "style": { "moonStyle": "default", "backgroundStyle": "stars" },
    "format": "png"
}
```

## Notes

**Images are cached.** An identical request returns the same URL without re-rendering.

**`format` accepts `png` or `svg`**, and defaults to `png`.