Repository navigation
Releases: a-know/Pixela
Release list
v1.36.1
[English]
The GET - /v1/users/<username>/graphs/<graphID> API now supports a new asText=true query parameter.
When this parameter is specified, the SVG data is returned with Content-Type: text/plain instead of the default image/svg+xml. The response body itself remains unchanged.
This option is useful for text-oriented clients, including AI-powered tools and web fetchers, that do not support responses with the image/svg+xml Content-Type.
If the parameter is omitted or a value other than true is specified, the response will continue to use image/svg+xml.
For more details, please see the Pixela API documentation.
[Japanese]
GET - /v1/users/<username>/graphs/<graphID> API にて、新たに asText=true クエリパラメータをサポートしました。
このパラメータを指定すると、SVGデータをデフォルトの image/svg+xml ではなく、Content-Type: text/plain で取得できます。レスポンスボディの内容そのものは変更されません。
このオプションは、image/svg+xml のレスポンスに対応していないAIツールやWeb取得ツールなど、テキストとしてレスポンスを扱うクライアントでの利用を想定したものです。
このパラメータを省略した場合、または true 以外の値を指定した場合は、従来どおり image/svg+xml でレスポンスします。
詳細は Pixela APIドキュメント を参照してください。
v1.36.0
[English]
Pixela now supports remote MCP (Model Context Protocol) server integration.
By configuring Pixela's MCP endpoint in an MCP-compatible client such as Codex, you can use Pixela through MCP tools from that client.
Endpoint and Documentation:
https://pixe.la/mcp
For example, in Codex, you can configure Pixela MCP as follows:
[mcp_servers.pixela]
url = "https://pixe.la/mcp"
bearer_token_env_var = "PIXELA_TOKEN"Then set your Pixela user token in the PIXELA_TOKEN environment variable before starting Codex.
Once configured, you can ask your MCP client to perform Pixela operations, such as listing graphs, creating graphs, posting Pixels, or updating today's Pixel.
Please note the following points:
- Pixela MCP uses your existing Pixela user token for authentication.
- When using Codex, the token is sent as an
Authorization: Bearer ...header. - When asking an MCP client to use Pixela MCP, include your Pixela username in the request if the client does not already know it.
- The token is used to authenticate the specified
username. If the username and token do not match, the request fails in the same way as the existing Pixela API.
For more details, please refer to the Pixela API documentation.
[Japanese]
Pixela を remote MCP(Model Context Protocol)サーバー連携に対応させました。
Codex などの MCP に対応したクライアントに Pixela の MCP エンドポイントを設定することで、そのクライアントから MCP tool として Pixela を利用できます。
エンドポイントとドキュメント:
https://pixe.la/mcp
たとえば Codex では、以下のように Pixela MCP を設定できます。
[mcp_servers.pixela]
url = "https://pixe.la/mcp"
bearer_token_env_var = "PIXELA_TOKEN"Codex を起動する前に、PIXELA_TOKEN 環境変数に Pixela user token を設定してください。
設定後は、MCP クライアントに対して Graph の一覧取得、Graph の作成、Pixel の投稿、今日の Pixel の更新などを依頼できるようになります。
ご利用の際には以下の点にご注意ください。
- Pixela MCP は、既存の Pixela user token を認証に利用します。
- Codex などのクライアントから利用する場合、token は
Authorization: Bearer ...ヘッダーとして送信されます。 - MCP クライアントがあなたの Pixela username を把握していない場合は、Pixela MCP を利用する依頼の中で username も指定してください。
- token は、指定された
usernameに対する認証に利用されます。username と token が一致しない場合は、既存の Pixela API と同様にリクエストは失敗します。
詳しくは Pixela API ドキュメントをご確認ください。
v1.35.0
[English]
We have added a new API endpoint, GET /v1/users/<username>/graphs/<graphID>/analyze, which allows you to have your graphs analyzed by AI and retrieve the results.
The overview and precautions are as follows.
- The AI analyzes the Pixel posted to the graph specified by and responds with the results in a string of up to approximately 1000 characters.
- Please pay attention to the following points.
- The analysis will cover Pixel posts from the last year.
- You cannot use this API if any of the following apply.
- If
allowAIProcessingis not set to true for the user. - In the case where a valid
thanks-codeis not set for the user (If you are not a Pixela Supporter). - If the number of Pixel posts within the last year is less than 30.
- If
- The AI analysis results are reset once a day.
- The language of the analysis results is determined based on the
timezonesetting configured in Graph. - You can obtain better analysis results by setting the description for the
Graph.
Please also refer to the API documentation when using this service.
[Japanese]
あなたのグラフをAIに分析させ、その結果を取得できるAPIエンドポイント、GET /v1/users/<username>/graphs/<graphID>/analyze を新たに追加しました。
概要および注意事項は以下のとおりです。
<graphID>で指定したグラフに投稿済みの Pixel を AI に分析させ、その結果を最大1000文字程度の文字列でレスポンスします。- 以下のような点に注意してください。
- 直近1年間に投稿された Pixel を分析対象とします。
- 以下のいずれかに当てはまる場合、このAPIを利用することはできません。
UserのallowAIProcessingに true が設定されていない場合。- User に有効な
thanks-codeが設定されていない場合(あなたが Pixela Supporter でない場合)。 - 直近1年間に投稿された Pixel の数が 30 に満たない場合。
- AIによる分析結果は1日に1度リセットされます。
Graphに設定されたtimezone設定を元に、分析結果の言語が決まります。Graphのdescriptionを設定することで、よりよい分析結果を得ることができます。
ご利用にあたっては、APIドキュメントもご確認ください。
また、開発者の個人ブログでもこのリリースについて紹介しています。よろしければご覧ください。Pixela グラフに投稿済みの数値データをAIに分析させることができるようになりました!
v1.34.0
[English]
We have enabled the specification of a new property, description, for Graphs. For more details, please refer to the relevant API documentation below.
- POST /v1/users/<username>/graphs - Create a graph
- PUT /v1/users/v<username>/graphs/<graphID> - Update a graph
The configured description can be viewed by hovering over it on the screen displayed in the GET /v1/users/<username>/graphs/<graphID>.html - View a graph detail , as shown below.
[Japanese]
Graph に対して新たなプロパティ description を指定できるようにしました。
詳細については、関連する以下のAPIドキュメントを参照してください。
- POST /v1/users/<username>/graphs - Create a graph
- PUT /v1/users/<username>/graphs/<graphID> - Update a graph
設定された description は、GET /v1/users/<username>/graphs/<graphID>.html - View a graph detail で表示される画面でマウスオーバーすることで、以下のように確認することができます。

v1.33.0
[English]
We have added the following two new API endpoints:
- PUT - /v1/users/<username>/graphs/<graphID>/<yyyyMMdd>/add
- PUT - /v1/users/<username>/graphs/<graphID>/<yyyyMMdd>/subtract
For details on each API, please refer to the linked API documentation.
These APIs will reject 25% of requests from users who are not Pixela Supporters (users with a valid thanks-code configured). For more details about Pixela Supporter, please refer to this Wiki Page.
[Japanese]
以下の2つのAPIエンドポイントを新しく追加しました。
- PUT - /v1/users/<username>/graphs/<graphID>/<yyyyMMdd>/add
- PUT - /v1/users/<username>/graphs/<graphID>/<yyyyMMdd>/subtract
各APIの詳細については、リンク先のAPIドキュメントをご確認ください。
これらのAPIは Pixela Supporter(有効な thanks-code が設定されているユーザー)以外のユーザーがリクエストした場合、25%の割合でリクエストがリジェクトされます。Pixela Supporter についての詳細はこちらの Wiki を参照してください。
v1.32.2
v1.32.1
[English]
The following two APIs now support the transparent=true query parameter.
This allows you to make the background of a graph transparent.
[Japanese]
以下の2つのAPIにて、 transparent=true クエリパラメータを新たにサポートしました。
これを指定すると、グラフの背景を透明にできます。
v1.32.0
[English]
Added new API endpoint /v1/users/<username>/graphs/<graphID>/today.
Using this API, you can retrieve the Pixel corresponding to the requested date. You can also control whether or not a 404 error will occur if the corresponding Pixel is unregistered.
See the API documentation for details.
[Japanese]
新しいAPIエンドポイント /v1/users/<username>/graphs/<graphID>/today を追加しました。
リクエストした日に対応する Pixel を取得できます。また、該当のPixelが未登録の場合に 404 エラーとするかどうかをコントロールすることも可能です。
詳細は API ドキュメントを参照してください。
v1.31.0
[English]
Added a new property startOnMonday that can be specified for Graph.
The default value for this property is false; specify true if you want the graph to start on Monday.
See the API documentation for details.
[Japanese]
Graph に指定可能な新しいプロパティ startOnMonday を追加しました。
このプロパティの既定値は false で、そのグラフを月曜始まりにしたい場合には true を指定します。
詳細は API ドキュメントを参照してください。
v1.30.0
[English]
GET - /v1/users/<username>/graphs/<graphID> API has supported 2 new options.
lessThan,greaterThan- This option is used to draw only pixels that are less than or greater than the value specified by this parameter.
- These two params cannot be specified at the same time.
- In the future, we are considering making it possible to specify also
GET - /v1/users/<username>/graphs/<graphID>.htmlAPI, but this is not supported at this time.
For more details. please see Pixela API docs.
[Japanese]
GET - /v1/users/<username>/graphs/<graphID> APIが、新たに2つのオプションをサポートしました。
lessThanとgreaterThan- このパラメータで指定した値以下、もしくは値以上の Pixel のみを描画するためのオプションです。
- これら2つのパラメータは同時に指定することはできません。
- 将来的には、これらのパラメータを
GET - /v1/users/<username>/graphs/<graphID>.htmlでも利用可能にすることを検討していますが、現時点では対応していません。
詳細はAPIドキュメントを参照してください。